deb-version(5)

NAMN
deb-version - Format på versionsnummer för Debianpaket

SYNOPS
[epok:]uppströmsversion[-debianuppdatering]

BESKRIVNING
Versionsnummer som används för Debians binär- och källkodspaket består av tre komponenter. De är:

epok
    Ett ensamt (vanligtvis litet) heltalsvärde större än noll. Det kan uteslutas, i så fall antas det vara noll. Om det utesluts kan inte uppströmsversion innehålla kolontecken.

    Fältet är till för att rätta till fel i versionsnummer i tidigare versioner av paketet, samt attr hantera förändringar i paketets versionsnumreringssystem.

uppströmsversion
    This is the main part of the version number. It is usually the version number of the original (“upstream”) package from which the .deb file has been made, if this is applicable. Usually this will be in the same format as that specified by the upstream author(s); however, it may need to be reformatted to fit into the package management system's format and comparison scheme.

    Hur pakethanteraren jämför versionsnummer när det gäller uppströmsversion beskrivs nedan. Fältet uppströmsversion i versionsnumret kan inte utelämnas.

    The upstream-version may contain only alphanumerics (“A-Za-z0-9”) and the characters . + - : ~ (full stop, plus, hyphen, colon, tilde) and should start with a digit. If there is no debian-revision then hyphens are not allowed; if there is no epoch then colons are not allowed.

debianuppdatering
    Denna del av versionsnumret anger versionen för Debianpaketet som baserats på uppströmsversionen. Den kan endast innehålla alfanumeriska tecken samt tecknen + . ~ (plus, punkt, tilde) och jämförs på samma sätt som uppströmsversion.

    It is optional; if it isn't present then the upstream-version may not contain a hyphen. This format represents the case where a piece of software was written specifically to be turned into a Debian package, and so there is only one “debianisation” of it and therefore no revision indication is required.

    It is conventional to restart the debian-revision at ‘1’ each time time the upstream-version is increased.

    Dpkg delar upp versionsnumret vid det sista bindestrecket i strängen (om sådant finns) för att bestämma uppströmsversion och debianuppdatering. Om debianuppdatering saknas räknas det som tidigare än om fältet existerar (men notera att debianuppdatering är den minst signifikanta delen av versionsnumret).

  Sorteringsalgoritm
Pakethanteringssystemet använder samma algoritm för att jämföra uppströmsversion- och debianuppdatering-delarna:

Strängarna jämförs från vänster till höger.

First the initial part of each string consisting entirely of non-digit characters is determined. These two parts (one of which may be empty) are compared lexically. If a difference is found it is returned. The lexical comparison is a comparison of ASCII values modified so that all the letters sort earlier than all the non-letters and so that a tilde sorts before anything, even the end of a part. For example, the following parts are in sorted order: ‘~~’, ‘~~a’, ‘~’, the empty part, ‘a’.

Därefter bestäms de inledande delar av varje sträng som enbart består av siffror. De numeriska värdena av dessa delar jämförs och om en skillnad upptäcks i jämförelsen returneras den som resultat av jämförelsen. För detta ändamål räknas en tom sträng (vilket bara kan uppstå i slutet av den ena eller båda versionssträngarna som jämförs) som noll.

Dessa båda steg (jämföra och ta bort inledande strängar med icke-siffror och siffror) upprepas till en jämförelse upptäcks eller de båda strängarna tar slut.

Note that the purpose of epochs is to allow us to leave behind mistakes in version numbering, and to cope with situations where the version numbering scheme changes. It is not intended to cope with version numbers containing strings of letters which the package management system cannot interpret (such as ‘ALPHA’ or ‘pre-’), or with silly orderings.

ANTECKNINGAR
Tildetecknets och dess speciella sorteringsegenskaper introducerades i dpkg 1.10 och vissa delar av dpkg-byggskripten fick inte stöd för det förrän senare i 1.10.x-serien.

SE ÄVEN
deb-control(5), deb(5), dpkg(1)

ÖVERSÄTTNING
Peter Krefting och Daniel Nylander.