NAAM

       deb-version - Indeling van het pakketversienummer in Debian

OVERZICHT

       [epoche:]toeleveraarsversie[-debian-revisie]

BESCHRIJVING

       De versienummers die gebruikt worden voor de binaire en broncodepakketten van Debian
       bestaan uit drie componenten. Die zijn:

       epoche
           Dit is een enkel (meestal klein) positief geheel getal. Het mag weggelaten worden en
           in dat geval wordt aangenomen dat het nul is. Indien het weggelaten wordt, mag de
           toeleveraarsversie geen dubbele punt bevatten.

           Het wordt gebruikt om te kunnen breken met een vergissing die bij de versienummering
           van een eerdere versie van het pakket gemaakt werd of met een vroeger
           versienummeringsschema.

       toeleveraarsversie
           Dit is het belangrijkste deel van het versienummer. Het is gewoonlijk het versienummer
           van het originele (“upstream”) pakket waarvan het .deb-bestand gemaakt werd, voor
           zover dit van toepassing is. Gewoonlijk wordt dezelfde indeling gebruikt als die welke
           door de auteurs van de software opgegeven wordt. Een herindeling kan nochtans nodig
           zijn om ze te laten passen binnen de indeling van het systeem voor pakketbeheer en
           -vergelijking.

           Het vergelijkingsgedrag van het pakketbeheerssysteem met betrekking tot de
           toeleveraarsversie wordt hierna beschreven. Het onderdeel toeleveraarsversie is een
           verplicht onderdeel van het versienummer.

           De toeleveraarsversie mag enkel alfanumerieke (“A-Za-z0-9”) tekens bevatten en de
           tekens . + - : ~ (punt, plus, verbindingsteken, dubbele punt, tilde) en moet met een
           cijfer beginnen. Als er geen debian-revisie is, mogen geen verbindingstekens gebruikt
           worden en als het onderdeel epoche ontbreekt, mogen geen dubbele punten gebruikt
           worden.

       debian-revisie
           Dit deel van het versienummer specificeert de versie van het Debian pakket, gebaseerd
           op de versie van de toeleveraar. Het mag enkel alfanumerieke tekens bevatten en de
           tekens + . ~ (plus, punt, tilde) en wordt op dezelfde manier vergeleken als de
           toeleveraarsversie.

           Het is facultatief. Als het ontbreekt, mag de toeleveraarsversie geen verbindingsteken
           bevatten. Deze indeling komt voor in het geval een stuk software geschreven werd met
           de specifieke bedoeling er een Debian pakket van te maken, zodat er slechts één enkele
           “debianisering” van bestaat en er daarom geen revisieaanduiding nodig is.

           Het is gebruikelijk om de debian-revisie terug op ‘1’ te laten beginnen telkens
           wanneer de toeleveraarsversie verhoogd wordt.

           Dpkg splitst het versienummer op bij het laatste verbindingstekenteken uit de
           tekenreeks (als er een in voorkomt) om te bepalen wat de toeleveraarsversie is en wat
           de debian-revisie. In een vergelijking is een versienummer zonder een debian-revisie
           een lagere versie dan één met een dergelijke component (maar merk op dat de debian-
           revisie het minst significante deel van een versienummer is).

   Sorteeralgoritme
       De onderdelen toeleveraarsversie en debian-revisie worden door het pakketbeheersysteem met
       behulp van hetzelfde algoritme vergeleken:

       De tekenreeksen worden vergeleken van links naar rechts.

       Eerst wordt van elke tekenreeks het eerste deel, dat volledig uit niet-numerieke tekens
       bestaat, bepaald. Deze twee delen (waarvan er een leeg mag zijn) worden lexicaal met
       elkaar vergeleken. Als een verschil aangetroffen wordt, wordt ze teruggegeven. Een
       lexicale vergelijking is een vergelijking van ASCII-waarden die aangepast wordt, zodat
       alle lettertekens in de ordening voor alle niet-lettertekens komen en zodat een tilde voor
       alles komt, zelfs het einde van een onderdeel. De volgende onderdelen zijn bijvoorbeeld in
       volgorde weergegeven: ‘~~’, ‘~~a’, ‘~’, het lege deel, ‘a’.

       Vervolgens wordt het eerste deel van de rest van elke tekenreeks dat volledig uit
       cijfertekens bestaat, bepaald. De numerieke waarden van deze twee delen worden vergeleken
       en een eventueel gevonden verschil wordt als resultaat van de vergelijking teruggegeven.
       In deze context geldt een lege tekenreeks (die enkel kan voorkomen op het einde van een of
       beide vergeleken versietekenreeksen) als een nul.

       Deze beide stappen (vergelijken en verwijderen van initiële niet-numerieke en initiële
       numerieke tekenreeksen) worden herhaald tot er een verschil gevonden wordt of tot beide
       tekenreeksen volledig afgelopen werden.

       Merk op dat een epoche bedoeld is om ons toe te laten fouten in versienummering achter ons
       te laten en te kunnen omgaan met situaties waarbij het versienummeringssysteem gewijzigd
       werd. Het is niet de bedoeling ervan te kunnen omgaan met versienummers die
       lettertekenreeksen bevatten die niet geïnterpreteerd kunnen worden door het
       pakketbeheersysteem (zoals ‘ALPHA’ of ‘pre-’), of met ondoordachte ordeningen.

OPMERKINGEN

       De bijzondere betekenis van het tilde-teken bij het sorteren werd geïntroduceerd in dpkg
       1.10 en sommige onderdelen van de bouwscripts van dpkg werden pas later in de
       1.10.x-cyclus in staat gesteld het te ondersteunen.

ZIE OOK

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