.\" -*- 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-substvars 5"
.TH deb-substvars 5 2024-03-10 1.22.6 "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, variabler
.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.
.SS Variabelsyntax
.IX Subsection "Variabelsyntax"
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.
.SS Filsyntax
.IX Subsection "Filsyntax"
Substitueringsvariabler kan anges i en fil. En s\(oadan fil best\(oar av rader p\(oa formen \fInamn\fR\fB=\fR\fIv\(:arde\fR eller \fInamn\fR\fB?=\fR<v\(:arde>. Operatorn \fB=\fR tilldelar en normal substitueringsvariabel, medan operatorn \fB?=\fR (sedan dpkg 1.21.8) tilldelar en valfri variabel som inte skriver ut n\(oagon varning \(:aven om den inte anv\(:ands. Avslutande blanksteg p\(oa en rad, blanka rader och rader som b\(:orjar med en \fB#\fR\-symbol (kommentarer) ignoreras.
.SS Substituering
.IX Subsection "Substituering"
Variabler kan s\(:attas genom att anv\(:anda den gemensamma kommandoradsflaggan \fB\-V\fR. De kan \(:aven anges i filen \fBdebian/substvars\fR (eller vilken som helst annan fil som anges med gemensamma flaggan \fB\-T\fR).
.PP
N\(:ar alla substitueringar har utf\(:orts ers\(:atts varje f\(:orekomst av str\(:angen \fB${}\fR (som inte \(:ar en faktisk substitueringsvariabel) med ett \fB$\fR\-tecken. Detta kan anv\(:andas som en ers\(:attningssekvens s\(oasom \fB${}{\fR\fIVARIABEL\fR\fB}\fR vilket kommer bli till \fB${\fR\fIVARIABLE\fR\fB}\fR i utdata.
.PP
Om en variabel refereras till men inte definieras kommer en varning att genereras och ett tomt v\(:arde anv\(:ands.
.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 "foo \(:ar bar.${Newline}foo \(:ar bra." 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
.SS "Inbyggda variabler"
.IX Subsection "Inbyggda variabler"
I till\(:agg \(:ar alltid f\(:oljande standardvariabler tillg\(:angliga:
.IP \fBArch\fR 4
.IX Item "Arch"
Aktuell v\(:ardarkitektur (dvs., arkitekturen paketet byggs f\(:or, motsvarigheten till \fBDEB_HOST_ARCH\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\-vendor\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).
.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.