.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "deb-version 7"
.TH deb-version 7 2024-01-24 1.22.4 "dpkg suite"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAMN
.IX Header "NAMN"
deb-version \- Format p\(oa versionsnummer f\(:or Debianpaket
.SH SYNOPS
.IX Header "SYNOPS"
[\fIepok\fR\fB:\fR]\fIuppstr\(:omsversion\fR[\fB\-\fR\fIdebianuppdatering\fR]
.SH BESKRIVNING
.IX Header "BESKRIVNING"
Versionsnummer som anv\(:ands f\(:or Debians bin\(:ar\- och k\(:allkodspaket best\(oar av tre komponenter. De \(:ar:
.IP \fIepok\fR 4
.IX Item "epok"
Ett ensamt (vanligtvis litet) heltalsv\(:arde st\(:orre \(:an noll. Det kan uteslutas, i s\(oa fall antas det vara noll. Om det utesluts kan inte \fIuppstr\(:omsversion\fR inneh\(oalla kolontecken.
.Sp
F\(:altet \(:ar till f\(:or att r\(:atta till fel i versionsnummer i tidigare versioner av paketet, samt attr hantera f\(:or\(:andringar i paketets versionsnumreringssystem.
.IP \fIuppstr\(:omsversion\fR 4
.IX Item "uppstr\(:omsversion"
Detta \(:ar huvuddelen av versionsnumret. Det \(:ar vanligtvis versionsnumret f\(:or originalpaketet (\(rquppstr\(:omspaketet\(rq) som \fI.deb\fR\-filen skapats fr\(oan, om ett s\(oadant finns. Normalt anges det p\(oa samma form som anv\(:ands av uppstr\(:omsf\(:orfattaren/f\(:orfattarna, men det kan beh\(:ova formateras om f\(:or att passa med pakethanterarens format och j\(:amf\(:orelsefunktion.
.Sp
Hur pakethanteraren j\(:amf\(:or versionsnummer n\(:ar det g\(:aller \fIuppstr\(:omsversion\fR beskrivs nedan. F\(:altet \fIuppstr\(:omsversion\fR i versionsnumret kan inte utel\(:amnas.
.Sp
F\(:altet \fIuppstr\(:omsversion\fR kan endast inneh\(oalla alfanumeriska tecken (\(rqA\-Za\-z0\-9\(rq) och tecknen \fB.\fR \fB+\fR \fB\-\fR \fB:\fR \fB~\fR (punkt, plus, bindestreck, kolon, tilde) och b\(:or inledas med en siffra. Om det inte finns n\(oagon \fIdebianuppdatering\fR till\(oats inte bindestreck och om det inte finns n\(oagon \fIepok\fR till\(oats inte kolontecken.
.IP \fIdebianuppdatering\fR 4
.IX Item "debianuppdatering"
Denna del av versionsnumret anger versionen f\(:or Debianpaketet som baserats p\(oa uppstr\(:omsversionen. Den kan endast inneh\(oalla alfanumeriska tecken samt tecknen \fB+\fR \fB.\fR \fB~\fR (plus, punkt, tilde) och j\(:amf\(:ors p\(oa samma s\(:att som \fIuppstr\(:omsversion\fR.
.Sp
F\(:altet \(:ar valfritt \- om det inte anges s\(oa kan inte \fIuppstr\(:omsversion\fR inneh\(oalla n\(oagot bindestreck. I s\(oa fall anger versionsnumret att en programvara skrivits specifikt f\(:or att g\(:oras till ett Debianpaket, och att det d\(oa endast finns en \(rqdebianisering\(rq av det och att d\(:arf\(:or beh\(:ovs ingen uppdateringsinformation vid sidan av.
.Sp
Vanligtvis b\(:orjar \fIdebianuppdatering\fR om p\(oa \(rq1\(rq varje g\(oang \fIuppstr\(:omsversion\fR \(:okas.
.Sp
Dpkg delar upp versionsnumret vid det sista bindestrecket i str\(:angen (om s\(oadant finns) f\(:or att best\(:amma \fIuppstr\(:omsversion\fR och \fIdebianuppdatering\fR. Om \fIdebianuppdatering\fR saknas r\(:aknas det som tidigare \(:an om f\(:altet existerar (men notera att \fIdebianuppdatering\fR \(:ar den minst signifikanta delen av versionsnumret).
.SS Sorteringsalgoritm
.IX Subsection "Sorteringsalgoritm"
Pakethanteringssystemet anv\(:ander samma algoritm f\(:or att j\(:amf\(:ora \fIuppstr\(:omsversion\fR\- och \fIdebianuppdatering\fR\-delarna:
.PP
Str\(:angarna j\(:amf\(:ors fr\(oan v\(:anster till h\(:oger.
.PP
F\(:orst best\(:ams de inledande delar av varje str\(:ang som enbart best\(oar av tecken som inte \(:ar siffror. Dessa b\(oada delar (av vilka den ena kan vara tom) j\(:amf\(:ors lexikalt. Om en skillnad uppt\(:acks returneras den. Den lexikala j\(:amf\(:orelsen j\(:amf\(:or ASCII\-v\(:arden, modifierad s\(oa att alla bokst\(:aver sorteras f\(:ore alla icke\-bokst\(:aver och s\(oa att ett tilde sorteras f\(:ore allt, \(:aven i slutet av delstr\(:angen. Till exempel \(:ar f\(:oljande delstr\(:angar sorterade: \(rq~~\(rq, \(rq~~a\(rq, \(rq~\(rq, tomma delstr\(:angen, \(rqa\(rq.
.PP
D\(:arefter best\(:ams de inledande delar av varje str\(:ang som enbart best\(oar av siffror. De numeriska v\(:ardena av dessa delar j\(:amf\(:ors och om en skillnad uppt\(:acks i j\(:amf\(:orelsen returneras den som resultat av j\(:amf\(:orelsen. F\(:or detta \(:andam\(oal r\(:aknas en tom str\(:ang (vilket bara kan uppst\(oa i slutet av den ena eller b\(oada versionsstr\(:angarna som j\(:amf\(:ors) som noll.
.PP
Dessa b\(oada steg (j\(:amf\(:ora och ta bort inledande str\(:angar med icke-siffror och siffror) upprepas till en j\(:amf\(:orelse uppt\(:acks eller de b\(oada str\(:angarna tar slut.
.PP
Observera att epokf\(:altet \(:ar till f\(:or att kunna r\(:atta till tidigare misstag i versionsnumreringen, och att hantera situationer d\(:ar versionsnumreringsmetoden \(:andras. Det \(:ar \fBinte\fR t\(:ankt att hantera versionsnummer som inneh\(oaller str\(:angar av bokst\(:aver som pakethanteringssystemet inte kan tolka (till exempel \(rqALPHA\(rq eller \(rqPre\-\(rq), eller dumma sorteringsordningar.
.SH ANTECKNINGAR
.IX Header "ANTECKNINGAR"
Tildetecknets och dess speciella sorteringsegenskaper introducerades i dpkg 1.10 och vissa delar av dpkg-byggskripten fick inte st\(:od f\(:or det f\(:orr\(:an senare i 1.10.x\-serien.
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdeb\-control\fR\|(5), \fBdeb\fR\|(5), \fBdpkg\fR\|(1)
.SH \(:OVERS\(:ATTNING
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.