BEZEICHNUNG

       deb-version - Versionsnummer-Format von Debian-Paketen

ÜBERSICHT

       [ Epoche:]Upstream-Version[-Debian-Revision]

BESCHREIBUNG

       Die für Debian Binär- und Quellpakete verwendete Versionsnummer besteht aus drei Komponenten. Diese sind:

       Epoche
           Dies  ist  eine einzelne (typischerweise kleine) vorzeichenlose ganze Zahl. Sie darf entfallen, wobei
           dann Null  angenommen  wird.  Falls  sie  entfällt,  darf  die  Upstream-Version  keine  Doppelpunkte
           enthalten.

           Sie existiert, um Fehler in den Versionsnummern älterer Versionen des Pakets zu erlauben und auch, um
           das bisherige Nummerierungsschema eines Paketes aufzugeben.

       Upstream-Version
           Dies   ist   der  Hauptteil  der  Versionsnummer.  Normalerweise  ist  dies  die  Versionsnummer  des
           Originalpakets  („Upstream“),  aus  dem  die  .deb-Datei  erstellt  wurde,   falls   dies   zutrifft.
           Normalerweise  wird  diese  im  gleichen  Format vorliegen, wie sie von den Originalautoren angegeben
           wurde; allerdings kann  es  notwendig  sein,  sie  umzuformatieren,  damit  sie  in  das  Format  des
           Paketverwaltungssystems und des Vergleichsschemas passt.

           Das  Vergleichsverhalten  des  Paketverwaltungssystems  in  Hinblick  auf  die  Upstream-Version wird
           nachfolgend beschrieben. Der Upstream-Version-Anteil der Versionsnummer muss angegeben werden.

           Upstream-Version darf nur alphanumerische Zeichen („A-Za-z0-9“) und .  +  -  :  ~  (Satzpunkt,  Plus,
           Bindestrich, Doppelpunkt, Tilde) enthalten und sollte mit einer Zahl beginnen. Falls es keine Debian-
           Revision  gibt,  sind Bindestriche nicht erlaubt; falls es keine Epoche gibt, sind Doppelpunkte nicht
           erlaubt.

       Debian-Revision
           Dieser Teil der Versionsnummer spezifiziert die Version des Debian-Paketes, basierend auf der Version
           der Originalautoren. Er kann nur alphanumerische Zeichen und + . ~ (Plus, Satzpunkt, Tilde) enthalten
           und wird genauso wie die Upstream-Version verglichen.

           Dieser Teil ist optional; falls er nicht vorhanden  ist,  darf  Upstream-Version  keinen  Bindestrich
           enthalten.  Dieses Format ist für den Fall, dass ein Stück Software speziell dafür geschrieben wurde,
           ein  Debian-Paket  zu  werden  und  es  daher  nur  eine  „Debianisierung“  gibt  und   somit   keine
           Revisionsanzeige notwendig ist.

           Es  ist üblich, die Debian-Revision jedesmal bei ‚1’ neu zu starten, wenn die Upstream-Version erhöht
           wird.

           Dpkg wird die Versionsnummer beim letzten Bindestrich in der Zeichenkette  auftrennen  (falls  dieser
           existiert),  um die Upstream-Version und die Debian-Revision zu bestimmen. Im Vergleich befindet sich
           eine fehlende Debian-Revision vor einer vorhandenen (beachten Sie aber, dass es sich bei der  Debian-
           Revision um den Teil der Versionsnummer mit der geringsten Signifikanz handelt).

   Sortieralgorithmus
       Die  Upstream-Version-  und  Debian-Revision-Teile  werden  von  der  Paketverwaltung  nach  dem gleichen
       Algorithmus verglichen:

       Die Zeichenketten werden von links nach rechts verglichen.

       Zuerst wird der Anfangsteil jeder Zeichenkette bestimmt, der komplett aus nicht-Ziffern-Zeichen  besteht.
       Diese  zwei  Teile  (von  denen einer leer sein kann) werden lexikalisch verglichen. Wird ein Unterschied
       gefunden, wird dieser zurückgeliefert. Der lexikalische  Vergleich  ist  ein  veränderter  Vergleich  von
       ASCII-Werten,  bei  denen  Buchstaben  vor allen nicht-Buchstaben sortiert werden und die Tilde vor allem
       sortiert wird, sogar vor dem Ende eines Teiles. So sind zum Beispiel die folgenden  Teile  in  sortierter
       Reihenfolge: ‚~~’, ‚~~a’, ‚~’, der leere Teil, ‚a’.

       Dann  wird  der Anfangsteil des Restes jeder Zeichenkette bestimmt, der komplett aus Ziffern besteht. Der
       numerische Wert dieser zwei Teile wird verglichen, und jeder gefundene Unterschied wird als Ergebnis  des
       Vergleichs  zurückgeliefert.  Für  diesen  Zweck zählt die leere Zeichenkette (die nur am Ende einer oder
       beider der zu vergleichenden Versionszeichenketten erscheinen kann) als Null.

       Diese zwei Schritte (Vergleichen und Entfernen von nicht-Ziffern-Zeichenketten und  Ziffern-Zeichenketten
       am  Anfang)  werden  wiederholt,  bis  ein  Unterschied  gefunden wird oder beide Zeichenketten erschöpft
       wurden.

       Beachten Sie, dass Epochen uns erlauben, Fehler  in  der  Versionsnummerierung  zurückzulassen,  und  mit
       Situationen  umzugehen,  in  denen  sich  das Schema der Versionsnummerierung ändert. Sie sind nicht dazu
       gedacht,  mit  Versionsnummern  umzugehen,  die  Zeichenketten  aus   Buchstaben   enthalten,   die   das
       Paketverwaltungssystem   nicht   interpretieren  kann  (wie  ‚ALPHA’  oder  ‚pre-’))  oder  mit  unklugen
       Reihenfolgen.

BEMERKUNGEN

       Das Tilde-Zeichen und seine speziellen Sortiereigenschaften wurden in Dpkg  1.10  eingeführt  und  einige
       Teile der Bauskripte von Dpkg haben erst später in der 1.10.x-Serie Unterstützung dafür erhalten.

SIEHE AUCH

       deb-control(5), deb(5), dpkg(1)

ÜBERSETZUNG

       Die  deutsche  Übersetzung  wurde  2004,  2006-2025 von Helge Kreutzmann <debian@helgefjell.de>, 2007 von
       Florian  Rehnisch  <eixman@gmx.de>  und  2008  von  Sven  Joachim  <svenjoac@gmx.de>  angefertigt.  Diese
       Übersetzung  ist  Freie  Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer für
       die Kopierbedingungen. Es gibt KEINE HAFTUNG.

1.22.18                                            2025-04-28                                     deb-version(7)