Differences

This shows you the differences between two versions of the page.

--- autoupdater [2011/01/14 21:39] – added section about versioning glaubitz
+++ autoupdater [2011/01/16 20:53] – glaubitz
@@ Line 16: / Line 16: @@
 In order for the automatic updates to properly work, they need to be able to determine the version of the currently installed instance of the software package. The version number is commonly defined as a three-digit, dot-seperated number in the pattern: x.y.z where //x// denotes the //major//, //y// the minor and //z// the //patch level// version.
+The major version is usually increased when huge changes are introduced when reaching a milestone which justify a new milestone while the minor version is usually increased when new features are integrated or larger bugs are fixed. The patch level is increased when minor updates to the software were made, usually in form of smaller bugfixes and security updates.
+The first version of a software package is therefore usually denoted as //0.0.1//, which is also the case for [[qhimdtransfer]]. However, since the software is still under heavy development, we haven't made any official releases yet and are never increasing the version number up to now. In order to be still able to track any changes in development and thus updates, we can leverage the (abbreviated) hash of every individual commit which //git// creates. The hash for the current commit can be determined with //git describe//:
+<code>
+glaubitz@squeeze64:~/linux-minidisc> git describe --always
+a0b
+</code>
+The parameter "//--always//" is required since no tags, i.e. version numbers, have been defined in the git tree yet and thus a fallback to the abbreviated commit ID is forced.
+See: [[http://www.qtcentre.org/wiki/index.php?title=Version_numbering_using_QMake]]
 ===== Automatic Updates for QHiMDTransfer on MacOS =====