Difference between revisions of "Version numbering"

From Second Life Wiki
Jump to navigation Jump to search
Line 2: Line 2:




== What do the numbers in a release version mean? ==  
== Second Life Viewer Versioning ==  
* 1.x.y.z? And why is it sometimes 1.x.y(z)?
* For example, '''version 1.21.6(99587)'''


The Second Life Viewer uses a four-place version convention that is common to the software industry.  The four places in the '''<i>w.x.y.z</i>''' version string correspond to '''<i>Major.Minor.Patch.Revision</i>''', and combine to indicate the nature of each release.  Information describing circumstances under which each place is incremented has been provided in the following sections.


These version numbers follow a four place version convention common to the software industry. The four places of w.x.y.z-style release numbers are typically described as Major.Minor.Patch.Revision. 
Note: Individual Second Life viewer versions may be formatted as either "'''w.x.y.z'''" or "'''w.x.y (z)'''".  In 'Help > About Second Life', as well as in the release notes, we have standardized on the "'''w.x.y (z)'''" format, but either version format is considered correct.




=== '''w (Major)''' ===
----
 
=== Major Revision - '''w'''.<i>x.y.z</i> ===
The first place, or Major version, in each version number effectively represents the "generation" of Second Life.  Changes in the Major revision are reserved for comprehensive changes in the way Second Life looks and/or functions.  The best example is Viewer 2, which constituted a significant change in the look, feel and operation of Second Life - thereby justifying the Major version increment from 1 to 2.
The first place, or Major version, in each version number effectively represents the "generation" of Second Life.  Changes in the Major revision are reserved for comprehensive changes in the way Second Life looks and/or functions.  The best example is Viewer 2, which constituted a significant change in the look, feel and operation of Second Life - thereby justifying the Major version increment from 1 to 2.



Revision as of 10:49, 4 November 2010


Second Life Viewer Versioning

The Second Life Viewer uses a four-place version convention that is common to the software industry. The four places in the w.x.y.z version string correspond to Major.Minor.Patch.Revision, and combine to indicate the nature of each release. Information describing circumstances under which each place is incremented has been provided in the following sections.

Note: Individual Second Life viewer versions may be formatted as either "w.x.y.z" or "w.x.y (z)". In 'Help > About Second Life', as well as in the release notes, we have standardized on the "w.x.y (z)" format, but either version format is considered correct.



Major Revision - w.x.y.z

The first place, or Major version, in each version number effectively represents the "generation" of Second Life. Changes in the Major revision are reserved for comprehensive changes in the way Second Life looks and/or functions. The best example is Viewer 2, which constituted a significant change in the look, feel and operation of Second Life - thereby justifying the Major version increment from 1 to 2.

.x (Minor) and .y (Patch)

  • Linden Lab uses the second digit x to denote a substantial new feature or sizable release, for example:
    • 1.10 introduced flexi prims
    • 1.11 was a revamp of the UI layer
    • 1.12 had groups and estates improvements
    • 1.14 introduced render pipeline improvements
    • 1.20 introduced a "Silver" skin for the user interface
    • 1.21 introduced the ability to save scripts with the Mono scripting engine
    • 1.22 was a maintenance release with many bug fixes
    • and so on.
    • (The SL History Wiki http://secondlife.wikia.com/index.php/Release_Notes has unofficial archives of the release notes.)


  • In between these Minor 1.x versions are any improved builds (small iterations of little bug fixes) denoted by the third digit .y.
    • Most often, while a Minor 1.x version is in its beta or Release Candidate RC status, it will undergo 3-6 such build iterations. Thus it will typically become "official" with a number like 1.20.6.
    • EXCEPTION: In the versions from 1.15 to 1.19, Linden Lab switched to having the second digit (e.g. 1.19) denote a new viewer which was a mandatory upgrade for Residents, to go along with a server-side upgrade. Thus, from version 1.15 to 1.19, the in-between 1.x.y versions were any optional upgrades denoted by the third digit, y -- even those with substantial new features -- such as 1.19.1 introduced WindLight atmospheric rendering.


.z (Revision)

The final digit always represents a unique Revision number, which denotes internal changes only. The official released version of the Second Life viewer will only use the first three digits to have meaning (e.g. 1.20.6).

  • Some parts of the Second Life UI and Web site show this last digit in parenthesis (z) to emphasize the, er, parenthetical nature of that field - it shouldn’t be important except to software developers seeking a precise snapshot of when the code was packaged.