Provided by:
dpkg-dev_1.16.0.3ubuntu5_all 
NAME
deb-substvars - Substitutionsvariablen in Debian-Quellen
"UBERSICHT
substvars
BESCHREIBUNG
Bevor dpkg-source, dpkg-gencontrol und dpkg-genchanges ihre
Steuerinformationen (zu der Quellsteuer-Datei .dsc fur dpkg-source und
zu der Standardausgabe fur dpkg-gencontrol und dpkg-genchanges)
schreiben, fuhren sie einige Variablensubstitutionen in der
Ausgabedatei durch.
Eine Variablensubstitution hat die Form ${Variablenname}.
Variablennamen bestehen aus alphanumerischen Zeichen (womit sie auch
beginnen), Gedankenstrichen und Doppelpunkten. Variablensubstitutionen
werden wiederholt durchgefuhrt, bis keine ubrig geblieben sind; der
komplette Text des Feldes nach der Substitution wird erneut auf weitere
Substitutionen gepruft.
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 Steuerdatei
vorgenommen wird, werden einige dieser Felder wahrend des Bauens
benotigt und verwendet, wenn die Substitution noch nicht erfolgt ist.
Daher konnen 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 uber mehrere Zeilen
expandieren mochten, mussen Sie nach dem Zeilenumbruch daher kein
Leerzeichen einfugen. 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 fuhren:
Description: foo application
foo ist bar.
foo ist super.
.
Weiterer Text.
Variablen konnen uber die allgemeine -V-Option gesetzt werden. Sie
konnen auch in der debian/substvars (bzw. in der uber die Option -T
gesetzten Datei) angegeben werden. Diese Datei besteht auch Zeilen der
Form Name=Wert. Leerzeichen am Zeilenende, leere Zeilen und Zeilen, die
mit dem #-Symbol starten (Kommentare) werden ignoriert.
Zusatzlich sind die folgenden Standardvariablen verfugbar:
Arch Die aktuelle Bau-Architektur (von dpkg --print-architecture).
source:Version
Die Quellpaket-Version.
source:Upstream-Version
Die Paketversion der Originalautoren, einschlieBlich der Epoche
der Debian-Version, falls vorhanden.
binary:Version
Die Binarpaketversion (die z.B. in einem binNMU von
source:Version abweichen kann).
Source-Version
Die Quellpaketversion (aus der changelog-Datei). Diese Variable
ist jetzt veraltet, da ihre Bedeutung von ihrer Funktion
abweicht, bitte verwenden Sie source:Version oder binary:Version
wo zutreffend.
Installed-Size
Die GesamtgroBe der vom Paket installierten Dateien. Dieser Wert
wird in das entsprechende Feld der >>control<<-Datei kopiert;
wird es gesetzt, verandert es den Wert dieses Feldes. Falls
diese Variable nicht gesetzt ist, wird dpkg-gencontrol >>du -k
debian/tmp<< verwenden, um den Standardwert zu ermitteln.
Extra-Size
Zusatzlicher 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.
F:Feldname
Der Wert des Ausgabefeldes Feldname (der in der kanonischen
GroB-/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 geandert.
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.
dpkg:Version
Die komplette Version von Dpkg.
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.
FEHLER
Die Stelle, an der das Uberschreiben von Feldern passiert, verglichen
mit bestimmten Standard-Ausgabe-Feldeinstellungen, ist eher konfus.
"UBERSETZUNG
Die deutsche Ubersetzung wurde 2004, 2006-2011 von Helge Kreutzmann
<debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
2008 von Sven Joachim <svenjoac@gmx.de> angefertigt. Diese Ubersetzung
ist Freie Dokumentation; lesen Sie die GNU General Public License
Version 2 oder neuer fur die Kopierbedingungen. Es gibt KEINE HAFTUNG.
SIEHE AUCH
dpkg(1), dpkg-genchanges(1), dpkg-gencontrol(1), dpkg-shlibdeps(1),
dpkg-source(1).
AUTOR
Copyright (C) 1995-1996 Ian Jackson
Copyright (C) 2000 Wichert Akkerman
Dies ist Freie Software; lesen Sie die GNU General Public License
Version 2 oder neuer fur die Kopierbedingungen. Es gibt KEINE Haftung.