BEZEICHNUNG

       deb-substvars - Substitutionsvariablen in Debian-Quellen

ÜBERSICHT

       substvars

BESCHREIBUNG

       Bevor    dpkg-source,    dpkg-gencontrol   und   dpkg-genchanges   ihre   Steuerinformationen   (zu   der
       Quell-control-Datei  .dsc  für  dpkg-source  und  zu  der   Standardausgabe   für   dpkg-gencontrol   und
       dpkg-genchanges) schreiben, führen sie einige Variablensubstitutionen in der Ausgabedatei durch.

       Eine  Variablensubstitution  hat  die Form ${Variablenname}. Variablennamen bestehen aus alphanumerischen
       Zeichen  (a-zA-Z0-9,  womit  sie  auch  beginnen),  Gedankenstrichen  (-)  und  Doppelpunkten  (:).   Bei
       Variablennamen  ist  die Klein-/Großschreibung relevant, auch wenn sie sich auf Gebilde beziehen, die die
       Klein-/Großschreibung erhalten. Variablensubstitutionen werden wiederholt durchgeführt, bis  keine  übrig
       geblieben   sind;  der  komplette  Text  des  Feldes  nach  der  Substitution  wird  erneut  auf  weitere
       Substitutionen geprüft.

       Nachdem alle Substitutionen erfolgt sind, wird jedes Auftreten der Zeichenkette ${} (die  keine  erlaubte
       Substitution ist) durch das $-Zeichen ersetzt.

       Obwohl  die  Variablensubstitution  bei  allen  Feldern der control-Datei vorgenommen wird, werden einige
       dieser Felder während des Bauens benötigt und verwendet, wenn die Substitution noch  nicht  erfolgt  ist.
       Daher können Sie Variablen nicht in den Feldern Package, Source und Architecture verwenden.

       Variablenersetzung erfolgt am Inhalt der Felder, nachdem sie geparst (ausgewertet) wurden. Falls Sie eine
       Variable  über  mehrere  Zeilen  expandieren  möchten,  müssen  Sie  nach  dem  Zeilenumbruch  daher kein
       Leerzeichen einfügen. Dies passiert bei der Ausgabe des Feldes implizit. Ist beispielsweise die  Variable
       ${Description} auf »foo ist bar.${Newline}foo ist super.« gesetzt und Sie haben das folgende Feld:

        Description: foo application
         ${Description}
         .
         Weiterer Text.

       Dann wird dies zu Folgenden führen:

        Description: foo application
         foo ist bar.
         foo ist super.
         .
         Weiterer Text.

       Variablen  können  über  die allgemeine -V-Option gesetzt werden. Sie können auch in der debian/substvars
       (bzw. in der über die Option -T gesetzten Datei) angegeben werden. Diese Datei besteht  auch  Zeilen  der
       Form  Name=Wert.  Leerraumzeichen  am  Zeilenende,  leere Zeilen und Zeilen, die mit dem #-Symbol starten
       (Kommentare) werden ignoriert.

       Zusätzlich sind die folgenden Standardvariablen verfügbar:

       Arch   Die aktuelle Host-Architektur (d.h. die Architektur, für die das Paket gebaut wird, das Äquivalent
              zu DEB_HOST_ARCH).

       source:Version
              Die Quellpaketversion (seit Dpkg 1.13.19).

       source:Upstream-Version
              Die  Paketversion  der  Originalautoren,  einschließlich  der  Epoche  der  Debian-Version,  falls
              vorhanden (seit Dpkg 1.13.19).

       binary:Version
              Die  Binärpaketversion  (die  z.B.  in  einem  binNMU von source:Version abweichen kann; seit Dpkg
              1.13.19).

       Source-Version
              Die Quellpaketversion (aus der changelog-Datei). Diese Variable ist jetzt veraltet  und  gibt  bei
              der Benutzung einen Fehler aus, da ihre Bedeutung von ihrer Funktion abweicht, bitte verwenden Sie
              source:Version oder binary:Version wo zutreffend.

       source:Synopsis
              Die  Quellpaketzusammenfassung, aus dem Feld Description der Quellabsatzes entnommen, falls dieses
              existiert (seit Dpkg 1.19.0).

       source:Extended-Description
              Die erweiterte Quellpaketbeschreibung, aus dem Feld Description des Quellabsatzes entnommen, falls
              dieses existiert (seit Dpkg 1.19.0).

       Installed-Size
              Die  ungefähre  Gesamtgröße  der  vom  Paket  installierten  Dateien.  Dieser  Wert  wird  in  das
              entsprechende  Feld  der  »control«-Datei  kopiert;  wird es gesetzt, verändert es den Wert dieses
              Feldes. Falls diese Variable nicht gesetzt ist, wird dpkg-gencontrol  den  Vorgabewert  berechnen,
              indem  es  die Größen jeder regulären Datei und jedes Symlinks (gerundet auf 1 KiB) aufsammelt und
              einen Grundwert von 1 KiB für aller anderen Dateisystemobjekttypen verwendet.

              Hinweis: Beachten Sie, dass dies stets nur ein Schätzwert sein kann, da die tatsächliche Größe  im
              installierten System stark vom verwandten Dateisystem und seinen Parametern abhängt. Daher kann es
              am Ende mehr oder weniger als in diesem Feld angegebenen Platz belegen.

       Extra-Size
              Zusätzlicher  Plattenplatz,  der  verwendet  wird,  wenn  das  Paket  installiert ist. Falls diese
              Variable gesetzt ist, wird dieser Wert zu der Installed-Size-Variablen hinzuaddiert (egal  ob  sie
              explizit  gesetzt  oder der Standardwert verwendet wird), bevor sie in das Feld Installed-Size der
              »control«-Datei kopiert wird.

       S:Feldname
              Der Wert des  Quellpaket-Absatzfeldes  Feldname  (der  in  der  kanonischen  Groß-/Kleinschreibung
              angegeben  werden  muss;  seit  Dpkg  1.18.11). Das Setzen dieser Variablen hat nur an den Stellen
              einen Effekt, wo diese explizit expandiert werden. Diese Variablen sind nur bei der Erstellung der
              binären Steuerdatei verfügbar.

       F:Feldname
              Der Wert des Ausgabefeldes Feldname (der in der kanonischen Groß-/Kleinschreibung angegeben werden
              muss). Das Setzen dieser Variablen hat  nur  einen  Effekt  an  den  Stellen,  wo  diese  explizit
              expandiert werden.

       Format Die  Formatversion  der  .changes-Datei,  die von dieser Version der Quellpaketierskripte erstellt
              wird. Falls Sie diese Variable setzen, werden die Inhalte des Format-Feldes in der  .changes-Datei
              auch geändert.

       Newline, Space, Tab
              Diese  Variablen  enthalten  das  jeweils  korrespondieren Zeichen (Zeilenumbruch, Leerzeichen und
              Tabulator in dieser Reihenfolge).

       shlibs:dependencyfield
              Variableneinstellungen mit Namen dieser Form werden von dpkg-shlibdeps erstellt.

       dpkg:Upstream-Version
              Die Original- (Upstream-)Version von Dpkg (seit Dpkg 1.13.19).

       dpkg:Version
              Die komplette Version von Dpkg (seit Dpkg 1.13.19).

       Falls auf eine Variable Bezug genommen wird, diese  aber  nicht  definiert  ist,  wird  es  eine  Warnung
       erstellen und ein leerer Wert wird angenommen.

DATEIEN

       debian/substvars
              Liste von Substitutionsvariablen und -werten.

SIEHE AUCH

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

ÜBERSETZUNG

       Die deutsche Übersetzung wurde 2004, 2006-2019 von Helge Kreutzmann <debian@helgefjell.de>, 2007 von
       Florian Rehnisch <eixman@gmx.de> und 2008 von Sven Joachim <svenjoac@gmx.de> angefertigt. Diese
       Übersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 2 oder neuer für
       die Kopierbedingungen. Es gibt KEINE HAFTUNG.

1.19.7                                             2022-05-25                                   deb-substvars(5)