SahanaPy Version Numbering

General Schema

Version numbering follows the following schema:

  [major].[minor].[version]-[branch]-[commit]

major	Major Release Number, starting with 0
minor	Minor Release Number, starting with 1
version	Release Version, even numbers = stable version, odd numbers = development version
branch	Name of the branch, omit for main trunk
commit	Branch commit number, omit for stable versions

Stable versions must have their release and version numbers in the bzr commit log.

• Bzr commits without release/version number in the commit log are always considered being unstable ("not ready for merge" in branches).
• Bzr commits with a release and (an even) version number on top of their commit log indicate a stable version ("ready for merge" in branches).

Version Numbers in Branches

The release/version number of a branch follows the main trunk, i.e. it indicates the trunk version it is synchronised with:

• 0.3.6-vita

uses the code from the 0.3.6 trunk version. Hence, if the branch is branched off another branch, it has to use the same version number as the original.

Version Numbers

Each new minor release starts with version number 0 in the stable, and 1 in the development version, i.e.:

• 0.3.0 is the initial stable version of the 0.3 release
• 0.3.1 is the initial development version of the 0.3 release

For each update of the stable version, both version numbers are increased by 2, that is, when 0.3.1 is tested and ready for release, so:

• 0.3.1 gets renumbered as 0.3.2 for release (stable 0.3.0=>0.3.2)
• new development version will be 0.3.3 (development 0.3.1=>0.3.3)

Examples

E.g.:

0.3.3-haiti-567

• Major Release: 0
• Minor Release: 3 ("Banwell")
• Version: 3 (development version)
• Branch: haiti (Haiti Earthquake 2010 Deployment Branch)
• Commit No.: 567

0.3.4-haiti

• Major Release: 0
• Minor Release: 3
• Version: 4 (stable version, no commit number!)
• Branch: haiti (Haiti Earthquake 2010 Deployment Branch)

0.3.6

• Major Release: 0
• Minor Release: 3 (Codename "Banwell")
• Version: 6 (stable version, main trunk)