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-2023 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.