summaryrefslogtreecommitdiffstats
path: root/man/sv/deb-substvars.pod
blob: 6e9d68240ed4bc28367978bc3630722ad8e43292 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAMN

deb-substvars - Debians källkods-substitueringsvariabler

=head1 SYNOPS

B<debian/substvars>, B<debian/>I<binärpaket>B<.substvars>, variabler

=head1 BESKRIVNING

Innan B<dpkg-source>, B<dpkg-gencontrol> och B<dpkg-genchanges> skriver sin styrinformation (till control-filen i källkodspaketet B<.dsc> för B<dpkg-source> och till standard ut för B<dpkg-gencontrol> och B<dpkg-genchanges>) kommer de utföra viss variabelsubstituering på utdatafilen.

=head2 Variabelsyntax

En variabelsubstitution har formen B<${>I<variabelnamn>B<}>. Variabelnamn består av alfanumeriska tecken (a-zA-Z0-9), bindestreck (-) och kolon (:) och börjar med ett alfanumeriskt tecken, och är skiftlägeskänsliga. Variabelsubstitueringar utförs upprepade gånger tills det inte kvarstår några - det resulterande innehållet i fältet läses av på nytt efter substitueringen för att se om det behövs fler substitueringar.

=head2 Filsyntax

Substitueringsvariabler kan anges i en fil. En sådan fil består av rader på formen I<namn>B<=>I<värde> eller I<namn>B<?=><värde>. Operatorn B<=> tilldelar en normal substitueringsvariabel, medan operatorn B<?=> (sedan dpkg 1.21.8) tilldelar en valfri variabel som inte skriver ut någon varning även om den inte används. Avslutande blanksteg på en rad, blanka rader och rader som börjar med en B<#>-symbol (kommentarer) ignoreras.

=head2 Substituering

Variabler kan sättas genom att använda den gemensamma kommandoradsflaggan B<-V>. De kan även anges i filen B<debian/substvars> (eller vilken som helst annan fil som anges med gemensamma flaggan B<-T>).

När alla substitueringar har utförts ersätts varje förekomst av strängen B<${}> (som inte är en faktisk substitueringsvariabel) med ett B<$>-tecken. Detta kan användas som en ersättningssekvens såsom B<${}{>I<VARIABEL>B<}> vilket kommer bli till B<${>I<VARIABLE>B<}> i utdata.

Om en variabel refereras till men inte definieras kommer en varning att genereras och ett tomt värde används.

Medan variabelsubstituering görs på alla fält i styrfilen är det några av fälten som används och behövs vid byggning innan substitueringen ännu har utförts. Därför går det inte att använda variabler i fälten B<Package>, B<Source> och B<Architecture>.

Variabelsubstituering sker över innehållet i fälten efter att de har tolkats, vilket innebär att om du vill att en variabel ska expanderas över flera rader så behöver du inte inkludera ett blanksteg efter nyradstecknet. Detta görs implicit när fältet skrivs ut. Till exempel, om variabeln B<${Description}> sätts till "foo är bar.${Newline}foo är bra." och du har följande fält:

 Description: programmet foo
  ${Description}
  .
  Mer text.

Så blir resultatet:

 Description: programmet foo
  foo är bar.
  foo är bra.
  .
  Mer text.

=head2 Inbyggda variabler

I tillägg är alltid följande standardvariabler tillgängliga:

=over 

=item B<Arch>

Aktuell värdarkitektur (dvs., arkitekturen paketet byggs för, motsvarigheten till B<DEB_HOST_ARCH>).

=item B<vendor:Name>

Aktuellt återförsäljarnamn (sedan dpkg 1.20.0). Värdet kommer från fältet B<Vendor> för aktuell återförsäljares origin-fil, så som B<dpkg-cendor>(1) skulle hämta det.

=item B<vendor:Id>

Aktuellt återförsäljar-ID (sedan dpkg 1.20.0). Det här bara en variant av B<vendor:Name> skriven med små bokstäver.

=item B<source:Version>

Källkodspaketets version (sedan dpkg 1.13.19).

=item B<source:Upstream-Version>

Version på uppströmskällkodspaketet, inklusive Debianversionens epok, om sådan finns (sedan dpkg 1.13.19).

=item B<binary:Version>

Den binära paketversionen (som kan avvika från B<source:Version>, till exempel i en binNMU; sedan dpkg 1.13.19).

=item B<Source-Version>

Versionen på källkodspaketet (från changelog-filen). Variabeln är nu B<föråldrad> och ger ett felmeddelande om den används eftersom betydelsen skiljer sig från funktionen, använd i stället B<source:Version> eller B<binary:Version> allt eftersom vad som är lämpligt.

=item B<source:Synopsis>

Källkodspaketets synops, hämtad från källkods-strofens B<Description>-fält, om det finns (sedan dpkg 1.19.0).

=item B<source:Extended-Description>

Källkodspaketet utökade beskricning, hämtad från källkods-strofens B<Description>-fält, om det finns (sedan dpkg 1.19.0).

=item B<Installed-Size>

Den ungefärliga totala storleken på paketets installerade filer. Värdet kopieras in i motsvarande fält i styrfilen. Om du ställer in det kommer det att ersätta värdet på fältet. Om variabeln inte är satt kommer B<dpkg-gencontrol> att beräkna dess standardvärde genom att summera storleken på alla vanliga filer och symboliska länkar avrundat till 1 KiB-enheter, och ett grundvärde på 1 KiB för andra filsystemsobjekttyper. Hårda länkar räknas bara som vanliga filer en gång.

B<Observera:> Tänk på att det här aldrig kan vara något annat än ett närmevärde eftersom den faktiska storleken som används på det installerade systemet i stor grad beror på vilket filsystem som används och dess parameterar, vilket kan komma att använda mer eller mindre plats än vad som anges i det här fältet.

=item B<Extra-Size>

Ytterligare diskutrymme som används när paketet installeras. Om värdet är satt kommer dess värde att läggas till B<Installed-Size>-variabelns värde (oavsett om den satts explicit eller om det förvalda värdet används) innan det kopieras till styrfilens fält B<Installed-Size>.

=item B<S:>I<fältnamn>

Värdet på källkods-strofens fält I<fältnamn> (som måste anges med rätt form av stora och små bokstäver; sedan dpkg 1.18.11). Om du sätter dessa variabler händer ingenting förutom där de explicit expanderats. Variablerna är bara tillgängliga när styrfiler för binärpaketen skapas.

=item B<F:>I<fältnamn>

Värdet på utdatafältet I<fältnamn> (som måste anges med rätt form av stora och små bokstäver). Om du sätter dessa variabler händer ingenting förutom där de explicit expanderats.

=item B<Format>

Formatet på filen B<.changes> som skapats av denna version av källkodspaketeringsskripten. Om du sätter denna variabel kommer innehållet i B<Format>-fältet i filen B<.changes> också att ändras.

=item B<Newline>, B<Space>, B<Tab>

Dessa variabler innehåller motsvarande tecken (radbrytning, blanksteg, tabbsteg).

=item B<shlibs:>I<beroendefält>

Variabelinställningar på den här formen skapas av B<dpkg-shlibdeps>.

=item B<dpkg:Upstream-Version>

Uppströmsversionen av dpkg (sedan dpkg 1.13.19).

=item B<dpkg:Version>

Fullständig version av dpkg (sedan dpkg 1.13.19).

=back

=head1 FILER

=over 

=item B<debian/substvars>

Lista över substitueringsvariabler och -värden.

=back

=head1 SE ÄVEN

B<dpkg>(1), B<dpkg-vendor>(1), B<dpkg-genchanges>(1), B<dpkg-gencontrol>(1), B<dpkg-shlibdeps>(1), B<dpkg-source>(1).


=head1 ÖVERSÄTTNING

Peter Krefting och Daniel Nylander.