Commit | Line | Data |
---|---|---|
1479465f GJ |
1 | .\" dpkg manual page - deb-substvars(5) |
2 | .\" | |
3 | .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk> | |
4 | .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org> | |
5 | .\" Copyright © 2006-2009,2012-2015 Guillem Jover <guillem@debian.org> | |
6 | .\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org> | |
7 | .\" | |
8 | .\" This is free software; you can redistribute it and/or modify | |
9 | .\" it under the terms of the GNU General Public License as published by | |
10 | .\" the Free Software Foundation; either version 2 of the License, or | |
11 | .\" (at your option) any later version. | |
12 | .\" | |
13 | .\" This is distributed in the hope that it will be useful, | |
14 | .\" but WITHOUT ANY WARRANTY; without even the implied warranty of | |
15 | .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
16 | .\" GNU General Public License for more details. | |
17 | .\" | |
18 | .\" You should have received a copy of the GNU General Public License | |
19 | .\" along with this program. If not, see <https://www.gnu.org/licenses/>. | |
20 | . | |
21 | .\"******************************************************************* | |
22 | .\" | |
23 | .\" This file was generated with po4a. Translate the source file. | |
24 | .\" | |
25 | .\"******************************************************************* | |
26 | .TH deb\-substvars 5 %RELEASE_DATE% %VERSION% dpkg\-suite | |
27 | .nh | |
28 | .SH NAAM | |
29 | deb\-substvars \- Substitutievariabelen in Debian broncode | |
30 | . | |
31 | .SH OVERZICHT | |
32 | substvars | |
33 | . | |
34 | .SH BESCHRIJVING | |
35 | Vooraleer \fBdpkg\-source\fP, \fBdpkg\-gencontrol\fP en \fBdpkg\-genchanges\fP hun | |
36 | comtrole\-informatie neerschrijven (naar het broncodecontrolebestand \fB.dsc\fP | |
37 | in het geval van \fBdpkg\-source\fP en naar standaarduitvoer in het geval van | |
38 | \fBdpkg\-gencontrol\fP en \fBdpkg\-genchanges\fP), voeren ze een aantal | |
39 | variabelesubstituties uit op het uitvoerbestand. | |
40 | ||
41 | Een variabelesubstitutie heeft als vorm | |
42 | \fB${\fP\fIvariabelenaam\fP\fB}\fP. Variabelenamen bestaan uit alfanumerieke tekens, | |
43 | koppeltekens en dubbele punten en beginnen met een alfanumeriek | |
44 | teken. Variabelesubstituties worden bij herhaling uitgevoerd tot er geen | |
45 | meer overblijven. Na een substitutie wordt de volledige tekst van het veld | |
46 | opnieuw doorzocht op nog meer uit te voeren substituties. | |
47 | ||
48 | Nadat alle substituties uitgevoerd werden, wordt de tekenreeks \fB${}\fP | |
49 | (hetgeen geen geldige substitutie is) overal waar die voorkomt, vervangen | |
50 | door het teken \fB$\fP. | |
51 | ||
52 | Hoewel variabelesubstitutie uitgevoerd wordt op alle controlevelden, zijn | |
53 | sommige van die velden nodig tijdens het bouwen wanneer de substitutie nog | |
54 | niet heeft plaats gevonden. Dat is de reden waarom u geen variabelen kunt | |
55 | gebruiken in de velden \fBPackage\fP, \fBSource\fP en \fBArchitecture\fP. | |
56 | ||
57 | Variabelesubstitutie vindt plaats op de inhoud van de velden nadat die | |
58 | ontleed werden. Indien u dus wenst dat een variabele zich uitstrekt over | |
59 | meerdere regels, moet u na het regeleinde geen spatie invoegen. Dit gebeurt | |
60 | impliciet bij de uitvoer van het veld. Indien bijvoorbeeld de variabele | |
61 | \fB${Description}\fP ingesteld werd op "foo is bar.${Newline}foo is geweldig." | |
62 | en u het volgende veld heeft: | |
63 | ||
64 | Description: toepassing foo | |
65 | ${Description} | |
66 | . | |
67 | Bijkomende tekst. | |
68 | ||
69 | zal dit resulteren in: | |
70 | ||
71 | Description: toepassing foo | |
72 | foo is bar. | |
73 | foo is geweldig. | |
74 | . | |
75 | Bijkomende tekst. | |
76 | ||
77 | Variabelen kunnen ingesteld worden met behulp van de algemene optie | |
78 | \fB\-V\fP. Ze kunnen ook opgegeven worden in het bestand \fBdebian/substvars\fP (of | |
79 | om het even welk ander bestand dat opgegeven werd met de optie \fB\-T\fP). Dit | |
80 | bestand bestaat uit regels die de vorm \fInaam\fP\fB=\fP\fIwaarde\fP | |
81 | hebben. Witruimte aan het einde van een regel, lege regels en regels die | |
82 | beginnen met het symbool \fB#\fP (commentaar) worden genegeerd. | |
83 | ||
84 | Bovendien kunnen de volgende standaardvariabelen gebruikt worden: | |
85 | .TP | |
86 | \fBArch\fP | |
87 | De huidige computerarchitectuur (d.w.z. de architectuur waarvoor het pakket | |
88 | gebouwd wordt; het equivalent van \fBDEB_HOST_ARCH\fP). | |
89 | .TP | |
90 | \fBsource:Version\fP | |
91 | De versie van het broncodepakket (sinds dpkg 1.13.19). | |
92 | .TP | |
93 | \fBsource:Upstream\-Version\fP | |
94 | De versie van het broncodepakket van de toeleveraar, eventueel met inbegrip | |
95 | van de versie\-epoche van Debian (sinds dpkg 1.13.19). | |
96 | .TP | |
97 | \fBbinary:Version\fP | |
98 | De versie van het binaire pakket (dat verschillend kan zijn van | |
99 | source:Version in geval van een binNMU bijvoorbeeld; sinds dpkg 1.13.19). | |
100 | .TP | |
101 | \fBSource\-Version\fP | |
102 | De versie van het broncodepakket (uit het bestand changelog). Deze variabele | |
103 | is nu \fBverouderd\fP en geeft aanleiding tot een foutmelding als hij gebruikt | |
104 | wordt, aangezien de betekenis ervan verschilt van zijn functie. U moet | |
105 | naargelang het geval nu \fBsource:Version\fP of \fBbinary:Version\fP gebruiken. | |
106 | .TP | |
107 | \fBInstalled\-Size\fP | |
108 | De geschatte totale grootte van de uit het pakket geïnstalleerde | |
109 | bestanden. Deze waarde wordt gekopieerd naar het overeenkomstige veld in het | |
110 | bestand control. Dit instellen wijzigt de waarde van dat veld. Indien deze | |
111 | variabele niet ingesteld werd, zal \fBdpkg\-gencontrol\fP de standaardwaarde | |
112 | berekenen door de grootte van alle gewone bestanden en alle symbolische | |
113 | koppelingen samen te nemen, afgerond tot op een eenheid van 1 KiB, en met | |
114 | een richtlijn van 1 KiB voor elk ander type object van het bestandssysteem. | |
115 | ||
116 | \fBOpmerking:\fP Houd er rekening mee dat dit steeds slechts een schatting kan | |
117 | zijn, aangezien de werkelijke grootte die op het geïnstalleerde systeem | |
118 | gebruikt zal worden, in grote mate afhankelijk is van het gebruikte | |
119 | bestandssysteem en de parameters ervan, waardoor het eindresultaat kan zijn | |
120 | dat ofwel meer ofwel minder ruimte in beslag genomen wordt dan in dit veld | |
121 | opgegeven werd. | |
122 | .TP | |
123 | \fBExtra\-Size\fP | |
124 | Extra schijfruimte die gebruikt wordt als het pakket geïnstalleerd | |
125 | is. Indien deze variabele ingesteld werd, wordt de waarde ervan opgeteld bij | |
126 | de variabele \fBInstalled\-Size\fP (ofwel de expliciet ingestelde of de | |
127 | standaardwaarde ervan) vooraleer ze gekopieerd wordt naar het veld | |
128 | \fBInstalled\-Size\fP in het bestand control. | |
129 | .TP | |
130 | \fBS:\fP\fIveldnaam\fP | |
131 | De waarde van het broncodeveld \fIveldnaam\fP (die moet opgegeven worden in de | |
132 | gebruikelijke schrijfwijze met hoofd\-/kleine letters; sinds dpkg | |
133 | 1.18.11). Het instellen van deze variabelen heeft geen effect tenzij op die | |
134 | plaatsen waar ze expliciet geëxpandeerd worden. Deze variabelen zijn enkel | |
135 | beschikbaar tijdens het genereren van de control\-bestanden van het binaire | |
136 | pakket. | |
137 | .TP | |
138 | \fBF:\fP\fIveldnaam\fP | |
139 | De waarde van het uitvoerveld \fIveldnaam\fP (die moet opgegeven worden in de | |
140 | gebruikelijke schrijfwijze met hoofd\-/kleine letters). Het instellen van | |
141 | deze variabelen heeft geen effect tenzij op die plaatsen waar ze expliciet | |
142 | geëxpandeerd worden. | |
143 | .TP | |
144 | \fBFormat\fP | |
145 | Het versienummer van de bestandsindeling van \fB.changes\fP dat door deze | |
146 | versie van de scripts voor het verpakken van de broncode gegenereerd | |
147 | wordt. Indien u deze variabele instelt, zal de inhoud van het veld \fBFormat\fP | |
148 | in het bestand \fB.changes\fP ook gewijzigd worden. | |
149 | .TP | |
150 | \fBNewline\fP, \fBSpace\fP, \fBTab\fP | |
151 | Elk van deze variabelen bevat het overeenkomstig letterteken. | |
152 | .TP | |
153 | \fBshlibs:\fP\fIdependencyfield\fP | |
154 | Variabele\-instellingen met namen in deze vorm worden door \fBdpkg\-shlibdeps\fP | |
155 | gegenereerd. | |
156 | .TP | |
157 | \fBdpkg:Upstream\-Version\fP | |
158 | De originele toeleveraarsversie (upstream) van dpkg (sinds dpkg 1.13.19). | |
159 | .TP | |
160 | \fBdpkg:Version\fP | |
161 | De volledige versie van dpkg (sinds dpkg 1.13.19). | |
162 | .LP | |
163 | Indien er gerefereerd wordt naar een niet\-gedefinieerde variabele, wordt een | |
164 | waarschuwing gegeven en wordt verondersteld dat de waarde ervan leeg is. | |
165 | . | |
166 | .SH BESTANDEN | |
167 | .TP | |
168 | \fBdebian/substvars\fP | |
169 | Lijst met substitutievariabelen en hun waarden. | |
170 | . | |
171 | .SH "ZIE OOK" | |
172 | .ad l | |
173 | \fBdpkg\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1), | |
174 | \fBdpkg\-shlibdeps\fP(1), \fBdpkg\-source\fP(1). |