Difference between revisions of "Version number"

From Luanti Wiki
Jump to navigation Jump to search
(→‎The full format: hash does not increase)
(Update 5.0.0)
Line 4: Line 4:
 
A stable release is any publicly released version of Minetest where we uploaded downloadable packages: https://www.minetest.net/downloads/
 
A stable release is any publicly released version of Minetest where we uploaded downloadable packages: https://www.minetest.net/downloads/
  
The version number of a stable release is a sequence of 3 or 4 natural numbers (usually 3), separated by dots. The leftmost number is the most significant number, denoting more and more significant changes. The full version number of Minetest is always displayed in the window title.
+
The version number of a stable release is a sequence of 3 natural numbers (including 0). The leftmost number is the most significant number, denoting more and more significant changes. The full version number of Minetest is always displayed in the window title.
  
     ZERO.MAJOR.MINOR
+
     MAJOR.MINOR.PATCH
  
* <code>ZERO</code> is the first number, which has always been 0 so far. The meaning of it is a great mystery that even well-versed scholars in Minetestology haven't uncovered yet, but it is of great importance and must not be left out … yet. However, because it's so strange (some might even say “pointless”), we have come to an agreement to destroy this number in future versions.
 
 
* <code>MAJOR</code> is increased by 1 for very significant and (usually gigantic) releases that change a lot of things (likely to be in a compability-breaking manner).
 
* <code>MAJOR</code> is increased by 1 for very significant and (usually gigantic) releases that change a lot of things (likely to be in a compability-breaking manner).
 
* <code>MINOR</code> is increased by 1 for regular releases that contain features and/or bugfixes. These releases can be large or small. Developers try to keep backwards-compability, but this is not always guaranteed.
 
* <code>MINOR</code> is increased by 1 for regular releases that contain features and/or bugfixes. These releases can be large or small. Developers try to keep backwards-compability, but this is not always guaranteed.
 +
* <code>PATCH</code> is increased by 1 for releases that only contain bugfixes. Usually these releases only change a few things and are usually very small and simple. These releases should be backwards-compatible. This number is only used when there actually has been a <code>PATCH</code> release after a <code>MINOR</code> or <code>MAJOR</code> release. Otherwise, it is not used.
  
Sometimes, a 4th number is appended:
+
When a new version is released, one of the numbers is increased, depending on the complexity of the release. The less-significant numbers are reset to 0. For example, if the current version is 5.1.2, and we want to make a <code>MINOR</code> release, the next version will be 5.2.0.
  
    ZERO.MAJOR.MINOR.PATCH
+
==== Old format (pre-5.0.0) ====
 +
This section is only for historic interest.
  
* <code>PATCH</code> is increased by 1 for releases that only contain bugfixes. Usually these releases only change a few things and are usually very small and simple. These releases should be backwards-compatible. This number is only used when there actually has been a <code>PATCH</code> release after a <code>MINOR</code> or <code>MAJOR</code> release. Otherwise, it is not used.
+
Before version 5.0.0, the version number was slightly different:
  
The first public version of Minetest was version 0.0.1.
+
    ZERO.MAJOR.MINOR
  
When a new version is released, one of the numbers is increased, depending on the complexity of the release. The less-significant numbers are reset to 0. If it was not a <code>PATCH</code> release, the <code>PATCH</code> number is dropped, otherwise, only the <code>PATCH</code> number is increased. For example, if the current version is 0.1.2.3, and we want to make a <code>MAJOR</code> release, the next version will be 0.2.0.
+
* <code>ZERO</code> is the first number, which was always 0 (before 5.0.0). The meaning of it is a great mystery that even well-versed scholars in Minetestology haven't uncovered yet, but it is of great importance and must not be left out. However, because it's so strange (some might even say “pointless”), it has been removed.
 +
* The meaning of <code>MAJOR</code> and <code>MINOR</code> is unchanged
  
=== Version number in the future ===
+
For patch releases, the <code>PATCH</code> number was appended:
After version 0.4.17.1, the version number scheme will change. Basically, the mysterious <code>ZERO</code> will be removed, and <code>MAJOR</code>, <code>MINOR</code> and <code>PATCH</code> move one place to the left. Also, the <code>PATCH</code> number is never dropped. The new format is this:
 
  
     MAJOR.MINOR.PATCH
+
     ZERO.MAJOR.MINOR.PATCH
  
The meaning of <code>MAJOR</code>, <code>MINOR</code> and <code>PATCH</code> is unchanged. The first version to use this scheme will be version 5.0.0. We'll skip right over versions 1.0.0, 2.0.0, 3.0.0 and 4.0.0.
+
The first public version of Minetest was version 0.0.1.
  
 
== Developer versions ==
 
== Developer versions ==

Revision as of 04:36, 7 March 2019

The version number of Minetest is used to keep different versions of Minetest apart.

Stable releases

A stable release is any publicly released version of Minetest where we uploaded downloadable packages: https://www.minetest.net/downloads/

The version number of a stable release is a sequence of 3 natural numbers (including 0). The leftmost number is the most significant number, denoting more and more significant changes. The full version number of Minetest is always displayed in the window title.

   MAJOR.MINOR.PATCH
  • MAJOR is increased by 1 for very significant and (usually gigantic) releases that change a lot of things (likely to be in a compability-breaking manner).
  • MINOR is increased by 1 for regular releases that contain features and/or bugfixes. These releases can be large or small. Developers try to keep backwards-compability, but this is not always guaranteed.
  • PATCH is increased by 1 for releases that only contain bugfixes. Usually these releases only change a few things and are usually very small and simple. These releases should be backwards-compatible. This number is only used when there actually has been a PATCH release after a MINOR or MAJOR release. Otherwise, it is not used.

When a new version is released, one of the numbers is increased, depending on the complexity of the release. The less-significant numbers are reset to 0. For example, if the current version is 5.1.2, and we want to make a MINOR release, the next version will be 5.2.0.

Old format (pre-5.0.0)

This section is only for historic interest.

Before version 5.0.0, the version number was slightly different:

   ZERO.MAJOR.MINOR
  • ZERO is the first number, which was always 0 (before 5.0.0). The meaning of it is a great mystery that even well-versed scholars in Minetestology haven't uncovered yet, but it is of great importance and must not be left out. However, because it's so strange (some might even say “pointless”), it has been removed.
  • The meaning of MAJOR and MINOR is unchanged

For patch releases, the PATCH number was appended:

   ZERO.MAJOR.MINOR.PATCH

The first public version of Minetest was version 0.0.1.

Developer versions

A so-called “developer version” (or “unstable version” if you're pessimistic) of Minetest is any state of Minetest that has not had a public, official, tested release with a stable version number. This is the case when you downloaded a daily build, or compiled Minetest from source code.

The short (and lazy) format

Long story short: If there's a “-dev” in the version number, it's a developer version.

The easiest way to mark a particular version as a “developer version” is to take the stable version number we expect to see in future and, then we append a “-dev” to it:

   <FUTURE_VERSION>-dev
  • <FUTURE_VERSION> is the stable version number we expect to release in future.
  • “-dev” is literally the text “-dev”. “dev” stands for, you guessed it, “development”.

For example, version 5.0.0-dev refers to a “developer version” that we expect to become (after changes, possibly) version 5.0.0 eventually.

But note this “short and lazy format” is not unambigious. It could refer to ANY “developer version” that exists between version 5.0.0 and 0.4.17.1 (the previous “stable” version), and is not specific. Your version 5.0.0-dev could be entirely different from the version 5.0.0-dev of your friend.

The full format

The full developer version number is a bit longer and is written in the window title:

   <FUTURE_VERSION>-dev-<COMMIT><DIRTY>
  • <COMMIT> are the first 8 characters of a hash of the Git commit that Minetest was compiled with. In simpler terms: This is just a bunch of letters and digits that probably uniquely identify your development version. Note this is not neccessarily in increasing order.
  • <DIRTY> is “-dirty” when your Minetest is said to be “dirty”. It becomes dirty when you have fiddled with any of the relevant files of the Minetest source code without committing them with Git. If you didn't touch anything, this should be empty.

For example, the version number “5.0.0-dev-a18c310a” means that this is a developer version of Minetest, with the Git commit hash “a18c310a”, and we believe this state of Minetest will (likely after many more changes) eventually become version 5.0.0.

An example for a “dirty” version would be “5.0.0-dev-a18c310a-dirty”.

If you want to report bugs, please always give us the full version number, which you see in the window title.

Minetest Game versioning

The releases of Minetest and Minetest Game are always in sync. They both share the same stable version numbers.