Version¶

Die Zeichenkette VERSION gibt die tatsächliche Version der paketierten Software an.

Diese Zeichenkette besteht aus alphanumerischen ASCII-Zeichen, die optional durch einen Punkt (.), einen Unterstrich (_) und das Plus-Zeichen (+) als Trenner sowie die Operatoren Tilde (~) und Caret (^) unterteilt sein können.

Die Operatoren werden verwendet, um Zeichenketten von Vor- und Nachveröffentlichungsversionen in eine stimmige Aktualisierung abzubilden.

Zu beachten ist, dass der Bindestrich (-) NICHT innerhalb von VERSION oder VERÖFFENTLICHUNG verwendet werden darf, da er als Komponententrennzeichen dient.

Veröffentlichung¶

Die VERÖFFENTLICHUNG spiegelt eine Revision innerhalb einer einzelnen Softwareversion wider. Idealerweise ist die VERÖFFENTLICHUNG eine einfache Ganzzahl, die bei Änderungen an einem Paket erhöht wird und bei Änderungen der Softwareversion (auf 1) zurückgesetzt werden sollte.

Technisch betrachtet ist das Format exakt das selbe wie für VERSION.

Epoche¶

Die EPOCHE ist eine nichtnegative Ganzzahl, die durch einen Doppelpunkt (:) von der Version getrennt ist. Es ist der wichtigste Teil eines EVR und korrigiert den Versionsvergleich dahingehend, dass eine ältere Version neuer erscheint. Es ist manchmal notwendig, Versionsanomalien zu umgehen, z.B. wenn ein Softwareprojekt sein Versionsschema ändert, aber auch um Paketierungsfehler zu korrigieren.

Wenn die Angabe der EPOCHE weggelassen wird, wird diese implizit als 0 angenommen.

Die Epoche sollte nur als eine Art »letzter Ausweg« angegeben werden. Eine solche Angabe verstößt gegen das Prinzip der geringsten Überraschung, und eine Änderung erfordert die entsprechende Aktualisierung aller zugehörigen versionierten Abhängigkeiten in anderen Paketen.

Vergleichen¶

Zwei EVRs werden komponentenweise von links nach rechts verglichen. Die Komponenten werden segmentweise von links nach rechts verglichen. Der Vergleich wird beendet, sobald ein Unterschied auf Segment- oder Komponentenebene festgestellt wird. Wenn sich also beispielsweise schon die Angaben der Epoche unterscheiden, wird der Rest des EVR überhaupt nicht berücksichtigt.

Innerhalb von Komponenten bilden aufeinanderfolgende alphabetische Zeichen und aufeinanderfolgende Zahlen implizite Segmente. Explizite Segmente werden durch Trennzeichen und Operatoren gekennzeichnet. Numerische Segmente werden numerisch verglichen, als Ganzzahlen, wobei führende Nullen ignoriert werden, andernfalls wird ein lexikografischer Vergleich verwendet. Das heißt, abc123 besteht aus zwei Segmenten: abc und 123 und ist trotz unterschiedlicher Darstellung gleich abc0123, abc.123 und abc.000123.

Ungeachtet ihres tatsächlichen Inhalts werden numerische Segmente stets als neuer als alphabetische Segmente angesehen. Wenn sie ansonsten gleich sind, wird die Komponente mit mehr Segmenten als neuer angesehen, und analog dazu ist eine EVR-Angabe mit mehr Komponenten neuer. Zum Beispiel ist 0.0 neuer als 0 und 1.xyz älter als 1.0, aber neuer als 1.

Die Zeichen des Segment-Trennzeichens werden nicht verglichen, so dass sie gegeneinander austauschbar verwendet werden können. Mehrere aufeinanderfolgende Trennzeichen werden so behandelt, als ob nur ein Trennzeichen verwendet würde. Somit ist 1.0 gleich 1+0 und 1+.+0.

Der Tilde-Operator, der für Vorabversionen verwendet wird, bewirkt, dass ein Segment als älter einsortiert wird. Beispielsweise ist 2.0~beta1 älter als 2.0 oder2.0~rc1 und neuer als 1.0. Der Caret-Operator ist im Wesentlichen das Gegenteil der Tilde. Er bewirkt, dass ein Segment nach neueren Versionen sortiert wird und wird für Nachveröffentlichungs-Schnappschüsse verwendet, die zwischen aktuellen Software-Veröffentlichungen existieren. Beispielsweise ist 2.0^150825 neuer als 2.0, aber älter als 2.0.1.