1 .\" dpkg manual page - deb-substvars(5)
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>
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.
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.
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/>.
21 .\"*******************************************************************
23 .\" This file was generated with po4a. Translate the source file.
25 .\"*******************************************************************
26 .TH deb\-substvars 5 %RELEASE_DATE% %VERSION% dpkg\-suite
29 deb\-substvars \- Substitutievariabelen in Debian broncode
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.
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.
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.
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.
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:
64 Description: toepassing foo
69 zal dit resulteren in:
71 Description: toepassing foo
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.
84 Bovendien kunnen de volgende standaardvariabelen gebruikt worden:
87 De huidige computerarchitectuur (d.w.z. de architectuur waarvoor het pakket
88 gebouwd wordt; het equivalent van \fBDEB_HOST_ARCH\fP).
91 De versie van het broncodepakket (sinds dpkg 1.13.19).
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).
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).
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.
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.
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
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.
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
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
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.
150 \fBNewline\fP, \fBSpace\fP, \fBTab\fP
151 Elk van deze variabelen bevat het overeenkomstig letterteken.
153 \fBshlibs:\fP\fIdependencyfield\fP
154 Variabele\-instellingen met namen in deze vorm worden door \fBdpkg\-shlibdeps\fP
157 \fBdpkg:Upstream\-Version\fP
158 De originele toeleveraarsversie (upstream) van dpkg (sinds dpkg 1.13.19).
161 De volledige versie van dpkg (sinds dpkg 1.13.19).
163 Indien er gerefereerd wordt naar een niet\-gedefinieerde variabele, wordt een
164 waarschuwing gegeven en wordt verondersteld dat de waarde ervan leeg is.
168 \fBdebian/substvars\fP
169 Lijst met substitutievariabelen en hun waarden.
173 \fBdpkg\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1),
174 \fBdpkg\-shlibdeps\fP(1), \fBdpkg\-source\fP(1).
~mdw / dpkg / blob