.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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-substvars 5"
.TH deb-substvars 5 "2022-09-01" "1.20.12" "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-substvars \- Debians k\(:allkods\-substitueringsvariabler
.SH "SYNOPS"
.IX Header "SYNOPS"
\&\fBdebian/substvars\fR, \fBdebian/\fR\fIbin\(:arpaket\fR\fB.substvars\fR
.SH "BESKRIVNING"
.IX Header "BESKRIVNING"
Innan \fBdpkg-source\fR, \fBdpkg-gencontrol\fR och \fBdpkg-genchanges\fR skriver sin
styrinformation (till control-filen i k\(:allkodspaketet \fB.dsc\fR f\(:or
\&\fBdpkg-source\fR och till standard ut f\(:or \fBdpkg-gencontrol\fR och
\&\fBdpkg-genchanges\fR) kommer de utf\(:ora viss variabelsubstituering p\(oa
utdatafilen.
.PP
En variabelsubstitution har formen \fB${\fR\fIvariabelnamn\fR\fB}\fR. Variabelnamn
best\(oar av alfanumeriska tecken (a\-zA\-Z0\-9), bindestreck (\-) och kolon (:)
och b\(:orjar med ett alfanumeriskt tecken, och \(:ar
skiftl\(:agesk\(:ansliga. Variabelsubstitueringar utf\(:ors upprepade g\(oanger tills
det inte kvarst\(oar n\(oagra \- det resulterande inneh\(oallet i f\(:altet l\(:ases av p\(oa
nytt efter substitueringen f\(:or att se om det beh\(:ovs fler substitueringar.
.PP
N\(:ar alla substitueringar har utf\(:orts ers\(:atts varje f\(:orekomst av str\(:angen
\&\fB${}\fR (som inte \(:ar en giltig substituering) med ett \fB$\fR\-tecken.
.PP
Medan variabelsubstituering g\(:ors p\(oa alla f\(:alt i styrfilen \(:ar det n\(oagra av
f\(:alten som anv\(:ands och beh\(:ovs vid byggning innan substitueringen \(:annu har
utf\(:orts. D\(:arf\(:or g\(oar det inte att anv\(:anda variabler i f\(:alten \fBPackage\fR,
\&\fBSource\fR och \fBArchitecture\fR.
.PP
Variabelsubstituering sker \(:over inneh\(oallet i f\(:alten efter att de har
tolkats, vilket inneb\(:ar att om du vill att en variabel ska expanderas \(:over
flera rader s\(oa beh\(:over du inte inkludera ett blanksteg efter
nyradstecknet. Detta g\(:ors implicit n\(:ar f\(:altet skrivs ut. Till exempel, om
variabeln \fB${Description}\fR s\(:atts till \*(L"foo \(:ar bar.${Newline}foo \(:ar bra.\*(R"
och du har f\(:oljande f\(:alt:
.PP
.Vb 4
\& Description: programmet foo
\&  ${Description}
\&  .
\&  Mer text.
.Ve
.PP
S\(oa blir resultatet:
.PP
.Vb 5
\& Description: programmet foo
\&  foo \(:ar bar.
\&  foo \(:ar bra.
\&  .
\&  Mer text.
.Ve
.PP
Variabler kan s\(:attas genom att anv\(:anda kommandoradsflaggan \fB\-V\fR. De kan
\(:aven anges i filen \fBdebian/substvars\fR (eller vilken som helst annan fil som
anges med flaggan \fB\-T\fR). Filen best\(oar av rader p\(oa formen
\&\fInamn\fR\fB=\fR\fIv\(:arde\fR. Avslutande blanksteg p\(oa en rad, blanka rader och rader
som b\(:orjar med en \fB#\fR\-symbol (kommentarer) ignoreras.
.PP
I till\(:agg \(:ar f\(:oljande standardvariabler tillg\(:angliga:
.IP "\fBArch\fR" 4
.IX Item "Arch"
Aktuell v\(:ardarkitektur (dvs., arkitekturen paketet byggs f\(:or, motsvarigheten
till \fB\s-1DEB_HOST_ARCH\s0\fR).
.IP "\fBvendor:Name\fR" 4
.IX Item "vendor:Name"
Aktuellt \(oaterf\(:ors\(:aljarnamn (sedan dpkg 1.20.0). V\(:ardet kommer fr\(oan f\(:altet
\&\fBVendor\fR f\(:or aktuell \(oaterf\(:ors\(:aljares origin-fil, s\(oa som \fBdpkg-cendor\fR(1)
skulle h\(:amta det.
.IP "\fBvendor:Id\fR" 4
.IX Item "vendor:Id"
Aktuellt \(oaterf\(:ors\(:aljar\-ID (sedan dpkg 1.20.0). Det h\(:ar bara en variant av
\&\fBvendor:Name\fR skriven med sm\(oa bokst\(:aver.
.IP "\fBsource:Version\fR" 4
.IX Item "source:Version"
K\(:allkodspaketets version (sedan dpkg 1.13.19).
.IP "\fBsource:Upstream\-Version\fR" 4
.IX Item "source:Upstream-Version"
Version p\(oa uppstr\(:omsk\(:allkodspaketet, inklusive Debianversionens epok, om
s\(oadan finns (sedan dpkg 1.13.19).
.IP "\fBbinary:Version\fR" 4
.IX Item "binary:Version"
Den bin\(:ara paketversionen (som kan avvika fr\(oan \fBsource:Version\fR, till
exempel i en binNMU; sedan dpkg 1.13.19).
.IP "\fBSource-Version\fR" 4
.IX Item "Source-Version"
Versionen p\(oa k\(:allkodspaketet (fr\(oan changelog-filen). Variabeln \(:ar nu
\&\fBf\(:or\(oaldrad\fR och ger ett felmeddelande om den anv\(:ands eftersom betydelsen
skiljer sig fr\(oan funktionen, anv\(:and i st\(:allet \fBsource:Version\fR eller
\&\fBbinary:Version\fR allt eftersom vad som \(:ar l\(:ampligt.
.IP "\fBsource:Synopsis\fR" 4
.IX Item "source:Synopsis"
K\(:allkodspaketets synops, h\(:amtad fr\(oan k\(:allkods\-strofens \fBDescription\fR\-f\(:alt,
om det finns (sedan dpkg 1.19.0).
.IP "\fBsource:Extended\-Description\fR" 4
.IX Item "source:Extended-Description"
K\(:allkodspaketet ut\(:okade beskricning, h\(:amtad fr\(oan k\(:allkods\-strofens
\&\fBDescription\fR\-f\(:alt, om det finns (sedan dpkg 1.19.0).
.IP "\fBInstalled-Size\fR" 4
.IX Item "Installed-Size"
Den ungef\(:arliga totala storleken p\(oa paketets installerade filer. V\(:ardet
kopieras in i motsvarande f\(:alt i styrfilen. Om du st\(:aller in det kommer det
att ers\(:atta v\(:ardet p\(oa f\(:altet. Om variabeln inte \(:ar satt kommer
\&\fBdpkg-gencontrol\fR att ber\(:akna dess standardv\(:arde genom att summera
storleken p\(oa alla vanliga filer och symboliska l\(:ankar avrundat till 1
KiB-enheter, och ett grundv\(:arde p\(oa 1 KiB f\(:or andra
filsystemsobjekttyper. H\(oarda l\(:ankar r\(:aknas bara som vanliga filer en g\(oang.
.Sp
\&\fBObservera:\fR T\(:ank p\(oa att det h\(:ar aldrig kan vara n\(oagot annat \(:an ett
n\(:armev\(:arde eftersom den faktiska storleken som anv\(:ands p\(oa det installerade
systemet i stor grad beror p\(oa vilket filsystem som anv\(:ands och dess
parameterar, vilket kan komma att anv\(:anda mer eller mindre plats \(:an vad som
anges i det h\(:ar f\(:altet.
.IP "\fBExtra-Size\fR" 4
.IX Item "Extra-Size"
Ytterligare diskutrymme som anv\(:ands n\(:ar paketet installeras. Om v\(:ardet \(:ar
satt kommer dess v\(:arde att l\(:aggas till \fBInstalled-Size\fR\-variabelns v\(:arde
(oavsett om den satts explicit eller om det f\(:orvalda v\(:ardet anv\(:ands) innan
det kopieras till styrfilens f\(:alt \fBInstalled-Size\fR.
.IP "\fBS:\fR\fIf\(:altnamn\fR" 4
.IX Item "S:f\(:altnamn"
V\(:ardet p\(oa k\(:allkods\-strofens f\(:alt \fIf\(:altnamn\fR (som m\(oaste anges med r\(:att form
av stora och sm\(oa bokst\(:aver; sedan dpkg 1.18.11). Om du s\(:atter dessa
variabler h\(:ander ingenting f\(:orutom d\(:ar de explicit expanderats. Variablerna
\(:ar bara tillg\(:angliga n\(:ar styrfiler f\(:or bin\(:arpaketen skapas.
.IP "\fBF:\fR\fIf\(:altnamn\fR" 4
.IX Item "F:f\(:altnamn"
V\(:ardet p\(oa utdataf\(:altet \fIf\(:altnamn\fR (som m\(oaste anges med r\(:att form av stora
och sm\(oa bokst\(:aver). Om du s\(:atter dessa variabler h\(:ander ingenting f\(:orutom
d\(:ar de explicit expanderats.
.IP "\fBFormat\fR" 4
.IX Item "Format"
Formatet p\(oa filen \fB.changes\fR som skapats av denna version av
k\(:allkodspaketeringsskripten. Om du s\(:atter denna variabel kommer inneh\(oallet i
\&\fBFormat\fR\-f\(:altet i filen \fB.changes\fR ocks\(oa att \(:andras.
.IP "\fBNewline\fR, \fBSpace\fR, \fBTab\fR" 4
.IX Item "Newline, Space, Tab"
Dessa variabler inneh\(oaller motsvarande tecken (radbrytning, blanksteg,
tabbsteg).
.IP "\fBshlibs:\fR\fIberoendef\(:alt\fR" 4
.IX Item "shlibs:beroendef\(:alt"
Variabelinst\(:allningar p\(oa den h\(:ar formen skapas av \fBdpkg-shlibdeps\fR.
.IP "\fBdpkg:Upstream\-Version\fR" 4
.IX Item "dpkg:Upstream-Version"
Uppstr\(:omsversionen av dpkg (sedan dpkg 1.13.19).
.IP "\fBdpkg:Version\fR" 4
.IX Item "dpkg:Version"
Fullst\(:andig version av dpkg (sedan dpkg 1.13.19).
.PP
Om en variabel refereras till men inte definieras kommer en varning att
genereras och ett tomt v\(:arde anv\(:ands.
.SH "FILER"
.IX Header "FILER"
.IP "\fBdebian/substvars\fR" 4
.IX Item "debian/substvars"
Lista \(:over substitueringsvariabler och \-v\(:arden.
.SH "SE \(:AVEN"
.IX Header "SE \(:AVEN"
\&\fBdpkg\fR(1), \fBdpkg-vendor\fR(1), \fBdpkg-genchanges\fR(1), \fBdpkg-gencontrol\fR(1),
\&\fBdpkg-shlibdeps\fR(1), \fBdpkg-source\fR(1).
.SH "\(:OVERS\(:ATTNING"
.IX Header "\(:OVERS\(:ATTNING"
Peter Krefting och Daniel Nylander.