NAAM

       deb-substvars - Substitutievariabelen in Debian broncode

OVERZICHT

       debian/substvars, debian/binary-package.substvars, variables

BESCHRIJVING

       Vooraleer dpkg-source, dpkg-gencontrol en dpkg-genchanges hun comtrole-informatie
       neerschrijven (naar het broncodecontrolebestand .dsc in het geval van dpkg-source en naar
       standaarduitvoer in het geval van dpkg-gencontrol en dpkg-genchanges), voeren ze een
       aantal variabelesubstituties uit op het uitvoerbestand.

   Variable Syntax
       Een variabelesubstitutie heeft als vorm ${variabelenaam}. 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.

   File Syntax
       Substitution variables can be specified in a file.  These files consist of lines of the
       form name=value or name?=value.  The = operator assigns a normal substitution variable,
       while the ?= operator (since dpkg 1.21.8) assigns an optional substitution variable which
       will emit no warnings even if unused.  Trailing whitespace on each line, blank lines, and
       lines starting with a # symbol (comments) are ignored.

   Substitution
       Variables can be set using the -V common option.  They can be also specified in the file
       debian/substvars (or whatever other file is specified using the -T common option).

       After all the substitutions have been done each occurrence of the string ${} (which is not
       an actual substitution variable) is replaced with a $ sign.  This can be used as an escape
       sequence such as ${}{VARIABLE} which will end up as ${VARIABLE} on the output.

       Indien er gerefereerd wordt naar een niet-gedefinieerde variabele, wordt een waarschuwing
       gegeven en wordt verondersteld dat de waarde ervan leeg is.

       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 Package, Source en
       Architecture.

       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 ${Description} ingesteld werd op "foo is bar.${Newline}foo is
       geweldig." en u het volgende veld heeft:

        Description: toepassing foo
         ${Description}
         .
         Bijkomende tekst.

       Dit zal dit resulteren in:

        Description: toepassing foo
         foo is bar.
         foo is geweldig.
         .
         Bijkomende tekst.

   Built-in Variable
       Additionally, the following standard variables are always available:

       Arch
           De huidige computerarchitectuur (d.w.z. de architectuur waarvoor het pakket gebouwd
           wordt; het equivalent van DEB_HOST_ARCH).

       vendor:Name
           De naam van de huidige leverancier (sinds dpkg 1.20.0). Deze waarde is afkomstig van
           het Vendor-veld voor het origin-bestand van de huidige leverancier, zoals dpkg-
           vendor(1) het zou ophalen.

       vendor:Id
           Het ID van de huidige leverancier (sinds dpkg 1.20.0). Dit is gewoon de variant van
           vendor:Name in kleine letters.

       source:Version
           De versie van het broncodepakket (sinds dpkg 1.13.19).

       source:Upstream-Version
           De versie van het broncodepakket van de toeleveraar, eventueel met inbegrip van de
           versie-epoche van Debian (sinds dpkg 1.13.19).

       binary:Version
           De versie van het binaire pakket (dat verschillend kan zijn van source:Version, in
           geval van een binNMU bijvoorbeeld; sinds dpkg 1.13.19).

       Source-Version
           De versie van het broncodepakket (uit het bestand changelog). Deze variabele is nu
           verouderd en geeft aanleiding tot een foutmelding als hij gebruikt wordt, aangezien de
           betekenis ervan verschilt van zijn functie. U moet naargelang het geval nu
           source:Version of binary:Version gebruiken.

       source:Synopsis
           De synopsis van het bronpakket, gehaald uit het veld Description van het broncode-
           element, als het bestaat (sinds dpkg 1.19.0).

       source:Extended-Description
           De uitgebreide beschrijving van het bronpakket, gehaald uit het veld Description van
           het broncode-element, als het bestaat (sinds dpkg 1.19.0).

       Installed-Size
           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 dpkg-gencontrol 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. Daarbij worden harde koppelingen slechts éénmaal geteld als een
           gewoon bestand.

           Opmerking: 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.

       Extra-Size
           Extra schijfruimte die gebruikt wordt als het pakket geïnstalleerd is. Indien deze
           variabele ingesteld werd, wordt de waarde ervan opgeteld bij de variabele Installed-
           Size (ofwel de expliciet ingestelde of de standaardwaarde ervan) vooraleer ze
           gekopieerd wordt naar het veld Installed-Size in het bestand control.

       S:veldnaam
           De waarde van het broncodeveld veldnaam (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.

       F:veldnaam
           De waarde van het uitvoerveld veldnaam (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.

       Format
           Het versienummer van de bestandsindeling van .changes 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 Format in het bestand .changes ook gewijzigd
           worden.

       Newline, Space, Tab
           Elk van deze variabelen bevat het overeenkomstig letterteken.

       shlibs:dependencyfield
           Variabele-instellingen met namen in deze vorm worden door dpkg-shlibdeps gegenereerd.

       dpkg:Upstream-Version
           De originele toeleveraarsversie (upstream) van dpkg (sinds dpkg 1.13.19).

       dpkg:Version
           De volledige versie van dpkg (sinds dpkg 1.13.19).

BESTANDEN

       debian/substvars
           Lijst met substitutievariabelen en hun waarden.

ZIE OOK

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