NAAM

       deb-substvars - Substitutievariabelen in Debian broncode

OVERZICHT

       substvars

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.

       Een variabelesubstitutie heeft  als  vorm  ${variabelenaam}.  Variabelenamen  bestaan  uit
       alfanumerieke  tekens,  koppeltekens  en  dubbele  punten en beginnen met een alfanumeriek
       teken. 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.

       Nadat alle substituties uitgevoerd werden, wordt de tekenreeks ${} (hetgeen  geen  geldige
       substitutie is) overal waar die voorkomt, vervangen door het teken $.

       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.

       zal dit resulteren in:

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

       Variabelen kunnen ingesteld worden met behulp van de algemene  optie  -V.  Ze  kunnen  ook
       opgegeven  worden  in  het bestand debian/substvars (of om het even welk ander bestand dat
       opgegeven werd met de optie -T). Dit bestand bestaat uit regels die  de  vorm  naam=waarde
       hebben.  Witruimte aan het einde van een regel, lege regels en regels die beginnen met het
       symbool # (commentaar) worden genegeerd.

       Bovendien kunnen de volgende standaardvariabelen gebruikt worden:

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

       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
              The binary package version (which may differ from source:Version in  a  binNMU  for
              example; since 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
              The source package synopsis, extracted from the source stanza Description field, if
              it exists (since dpkg 1.19.0).

       source:Extended-Description
              The   source  package  extended  description,  extracted  from  the  source  stanza
              Description field, if it exists (since 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.

              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).

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

BESTANDEN

       debian/substvars
              Lijst met substitutievariabelen en hun waarden.

ZIE OOK

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