181 lines
8.3 KiB
HTML
181 lines
8.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of deb-substvars</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>deb-substvars</H1>
|
|
Section: dpkg-suite (5)<BR>Updated: 2020-03-23<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAAM</H2>
|
|
|
|
deb-substvars - Substitutievariabelen in Debian broncode
|
|
<A NAME="lbAC"> </A>
|
|
<H2>OVERZICHT</H2>
|
|
|
|
substvars
|
|
<A NAME="lbAD"> </A>
|
|
<H2>BESCHRIJVING</H2>
|
|
|
|
Vooraleer <B>dpkg-source</B>, <B>dpkg-gencontrol</B> en <B>dpkg-genchanges</B> hun
|
|
comtrole-informatie neerschrijven (naar het broncodecontrolebestand <B>.dsc</B>
|
|
in het geval van <B>dpkg-source</B> en naar standaarduitvoer in het geval van
|
|
<B>dpkg-gencontrol</B> en <B>dpkg-genchanges</B>), voeren ze een aantal
|
|
variabelesubstituties uit op het uitvoerbestand.
|
|
<P>
|
|
Een variabelesubstitutie heeft als vorm
|
|
<B>${</B><I>variabelenaam</I><B>}</B>. Variabelenamen bestaan uit alfanumerieke tekens
|
|
(a-zA-Z0-9), koppeltekens (-) en dubbele punten (:) en beginnen met een
|
|
alfanumeriek teken. Ze zijn ook hoofdlettergevoelig, ook al kunnen ze
|
|
verwijzen naar andere entiteiten die hoofdletterbehoudend
|
|
zijn. Variabelesubstituties worden bij herhaling uitgevoerd tot er geen meer
|
|
overblijven. Na een substitutie wordt de volledige tekst van het veld
|
|
opnieuw doorzocht op nog meer uit te voeren substituties.
|
|
<P>
|
|
Nadat alle substituties uitgevoerd werden, wordt de tekenreeks <B>${}</B>
|
|
(hetgeen geen geldige substitutie is) overal waar die voorkomt, vervangen
|
|
door het teken <B>$</B>.
|
|
<P>
|
|
Hoewel variabelesubstitutie uitgevoerd wordt op alle controlevelden, zijn
|
|
sommige van die velden nodig tijdens het bouwen wanneer de substitutie nog
|
|
niet heeft plaats gevonden. Dat is de reden waarom u geen variabelen kunt
|
|
gebruiken in de velden <B>Package</B>, <B>Source</B> en <B>Architecture</B>.
|
|
<P>
|
|
Variabelesubstitutie vindt plaats op de inhoud van de velden nadat die
|
|
ontleed werden. Indien u dus wenst dat een variabele zich uitstrekt over
|
|
meerdere regels, moet u na het regeleinde geen spatie invoegen. Dit gebeurt
|
|
impliciet bij de uitvoer van het veld. Indien bijvoorbeeld de variabele
|
|
<B>${Description}</B> ingesteld werd op "foo is bar.${Newline}foo is geweldig."
|
|
en u het volgende veld heeft:
|
|
<P>
|
|
<BR> Description: toepassing foo
|
|
<BR> ${Description}
|
|
<BR> .
|
|
<BR> Bijkomende tekst.
|
|
<P>
|
|
zal dit resulteren in:
|
|
<P>
|
|
<BR> Description: toepassing foo
|
|
<BR> foo is bar.
|
|
<BR> foo is geweldig.
|
|
<BR> .
|
|
<BR> Bijkomende tekst.
|
|
<P>
|
|
Variabelen kunnen ingesteld worden met behulp van de algemene optie
|
|
<B>-V</B>. Ze kunnen ook opgegeven worden in het bestand <B>debian/substvars</B> (of
|
|
om het even welk ander bestand dat opgegeven werd met de optie <B>-T</B>). Dit
|
|
bestand bestaat uit regels die de vorm <I>naam</I><B>=</B><I>waarde</I>
|
|
hebben. Witruimte aan het einde van een regel, lege regels en regels die
|
|
beginnen met het symbool <B>#</B> (commentaar) worden genegeerd.
|
|
<P>
|
|
Bovendien kunnen de volgende standaardvariabelen gebruikt worden:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>Arch</B><DD>
|
|
De huidige computerarchitectuur (d.w.z. de architectuur waarvoor het pakket
|
|
gebouwd wordt; het equivalent van <B>DEB_HOST_ARCH</B>).
|
|
<DT id="2"><B>source:Version</B><DD>
|
|
De versie van het broncodepakket (sinds dpkg 1.13.19).
|
|
<DT id="3"><B>source:Upstream-Version</B><DD>
|
|
De versie van het broncodepakket van de toeleveraar, eventueel met inbegrip
|
|
van de versie-epoche van Debian (sinds dpkg 1.13.19).
|
|
<DT id="4"><B>binary:Version</B><DD>
|
|
De versie van het binaire pakket (dat verschillend kan zijn van
|
|
<B>source:Version</B>, in geval van een binNMU bijvoorbeeld; sinds dpkg
|
|
1.13.19).
|
|
<DT id="5"><B>Source-Version</B><DD>
|
|
De versie van het broncodepakket (uit het bestand changelog). Deze variabele
|
|
is nu <B>verouderd</B> en geeft aanleiding tot een foutmelding als hij gebruikt
|
|
wordt, aangezien de betekenis ervan verschilt van zijn functie. U moet
|
|
naargelang het geval nu <B>source:Version</B> of <B>binary:Version</B> gebruiken.
|
|
<DT id="6"><B>source:Synopsis</B><DD>
|
|
De synopsis van het bronpakket, gehaald uit het veld <B>Description</B> van het
|
|
broncode-element, als het bestaat (sinds dpkg 1.19.0).
|
|
<DT id="7"><B>source:Extended-Description</B><DD>
|
|
De uitgebreide beschrijving van het bronpakket, gehaald uit het veld
|
|
<B>Description</B> van het broncode-element, als het bestaat (sinds dpkg
|
|
1.19.0).
|
|
<DT id="8"><B>Installed-Size</B><DD>
|
|
De geschatte totale grootte van de uit het pakket geïnstalleerde
|
|
bestanden. Deze waarde wordt gekopieerd naar het overeenkomstige veld in het
|
|
bestand control. Dit instellen wijzigt de waarde van dat veld. Indien deze
|
|
variabele niet ingesteld werd, zal <B>dpkg-gencontrol</B> de standaardwaarde
|
|
berekenen door de grootte van alle gewone bestanden en alle symbolische
|
|
koppelingen samen te nemen, afgerond tot op een eenheid van 1 KiB, en met
|
|
een richtlijn van 1 KiB voor elk ander type object van het bestandssysteem.
|
|
<P>
|
|
<B>Opmerking:</B> Houd er rekening mee dat dit steeds slechts een schatting kan
|
|
zijn, aangezien de werkelijke grootte die op het geïnstalleerde systeem
|
|
gebruikt zal worden, in grote mate afhankelijk is van het gebruikte
|
|
bestandssysteem en de parameters ervan, waardoor het eindresultaat kan zijn
|
|
dat ofwel meer ofwel minder ruimte in beslag genomen wordt dan in dit veld
|
|
opgegeven werd.
|
|
<DT id="9"><B>Extra-Size</B><DD>
|
|
Extra schijfruimte die gebruikt wordt als het pakket geïnstalleerd
|
|
is. Indien deze variabele ingesteld werd, wordt de waarde ervan opgeteld bij
|
|
de variabele <B>Installed-Size</B> (ofwel de expliciet ingestelde of de
|
|
standaardwaarde ervan) vooraleer ze gekopieerd wordt naar het veld
|
|
<B>Installed-Size</B> in het bestand control.
|
|
<DT id="10"><B>S:</B><I>veldnaam</I><DD>
|
|
De waarde van het broncodeveld <I>veldnaam</I> (die moet opgegeven worden in de
|
|
gebruikelijke schrijfwijze met hoofd-/kleine letters; sinds dpkg
|
|
1.18.11). Het instellen van deze variabelen heeft geen effect tenzij op die
|
|
plaatsen waar ze expliciet geëxpandeerd worden. Deze variabelen zijn enkel
|
|
beschikbaar tijdens het genereren van de control-bestanden van het binaire
|
|
pakket.
|
|
<DT id="11"><B>F:</B><I>veldnaam</I><DD>
|
|
De waarde van het uitvoerveld <I>veldnaam</I> (die moet opgegeven worden in de
|
|
gebruikelijke schrijfwijze met hoofd-/kleine letters). Het instellen van
|
|
deze variabelen heeft geen effect tenzij op die plaatsen waar ze expliciet
|
|
geëxpandeerd worden.
|
|
<DT id="12"><B>Format</B><DD>
|
|
Het versienummer van de bestandsindeling van <B>.changes</B> dat door deze
|
|
versie van de scripts voor het verpakken van de broncode gegenereerd
|
|
wordt. Indien u deze variabele instelt, zal de inhoud van het veld <B>Format</B>
|
|
in het bestand <B>.changes</B> ook gewijzigd worden.
|
|
<DT id="13"><B>Newline</B>, <B>Space</B>, <B>Tab</B><DD>
|
|
Elk van deze variabelen bevat het overeenkomstig letterteken.
|
|
<DT id="14"><B>shlibs:</B><I>dependencyfield</I><DD>
|
|
Variabele-instellingen met namen in deze vorm worden door <B>dpkg-shlibdeps</B>
|
|
gegenereerd.
|
|
<DT id="15"><B>dpkg:Upstream-Version</B><DD>
|
|
De originele toeleveraarsversie (upstream) van dpkg (sinds dpkg 1.13.19).
|
|
<DT id="16"><B>dpkg:Version</B><DD>
|
|
De volledige versie van dpkg (sinds dpkg 1.13.19).
|
|
</DL>
|
|
<P>
|
|
|
|
Indien er gerefereerd wordt naar een niet-gedefinieerde variabele, wordt een
|
|
waarschuwing gegeven en wordt verondersteld dat de waarde ervan leeg is.
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BESTANDEN</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="17"><B>debian/substvars</B><DD>
|
|
Lijst met substitutievariabelen en hun waarden.
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ZIE OOK</H2>
|
|
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg">dpkg</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-genchanges">dpkg-genchanges</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-gencontrol">dpkg-gencontrol</A></B>(1),
|
|
<B><A HREF="/cgi-bin/man/man2html?1+dpkg-shlibdeps">dpkg-shlibdeps</A></B>(1), <B><A HREF="/cgi-bin/man/man2html?1+dpkg-source">dpkg-source</A></B>(1).
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NAAM</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">OVERZICHT</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">BESCHRIJVING</A><DD>
|
|
<DT id="21"><A HREF="#lbAE">BESTANDEN</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">ZIE OOK</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:19 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|