mdw@git.distorted.org.uk Git - dpkg/blob - man/de/deb-substvars.man

   1 .\" dpkg manual page - deb-substvars(5)
   2 .\"
   3 .\" Copyright © 1995-1996 Ian Jackson <ijackson@chiark.greenend.org.uk>
   4 .\" Copyright © 2000 Wichert Akkerman <wakkerma@debian.org>
   5 .\" Copyright © 2006-2009,2012-2015 Guillem Jover <guillem@debian.org>
   6 .\" Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org>
   7 .\"
   8 .\" This is free software; you can redistribute it and/or modify
   9 .\" it under the terms of the GNU General Public License as published by
  10 .\" the Free Software Foundation; either version 2 of the License, or
  11 .\" (at your option) any later version.
  12 .\"
  13 .\" This is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public License
  19 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  20 .
  21 .\"*******************************************************************
  22 .\"
  23 .\" This file was generated with po4a. Translate the source file.
  24 .\"
  25 .\"*******************************************************************
  26 .TH deb\-substvars 5 %RELEASE_DATE% %VERSION% dpkg\-Programmsammlung
  27 .nh
  28 .SH BEZEICHNUNG
  29 deb\-substvars \- Substitutionsvariablen in Debian\-Quellen
  30 .
  31 .SH ÜBERSICHT
  32 substvars
  33 .
  34 .SH BESCHREIBUNG
  35 Bevor \fBdpkg\-source\fP, \fBdpkg\-gencontrol\fP und \fBdpkg\-genchanges\fP ihre
  36 Steuerinformationen (zu der Quell\-control\-Datei \fB.dsc\fP für \fBdpkg\-source\fP
  37 und zu der Standardausgabe für \fBdpkg\-gencontrol\fP und \fBdpkg\-genchanges\fP)
  38 schreiben, führen sie einige Variablensubstitutionen in der Ausgabedatei
  39 durch.
  40
  41 Eine Variablensubstitution hat die Form
  42 \fB${\fP\fIVariablenname\fP\fB}\fP. Variablennamen bestehen aus alphanumerischen
  43 Zeichen (womit sie auch beginnen), Gedankenstrichen und
  44 Doppelpunkten. Variablensubstitutionen werden wiederholt durchgeführt, bis
  45 keine übrig geblieben sind; der komplette Text des Feldes nach der
  46 Substitution wird erneut auf weitere Substitutionen geprüft.
  47
  48 Nachdem alle Substitutionen erfolgt sind, wird jedes Auftreten der
  49 Zeichenkette \fB${}\fP (die keine erlaubte Substitution ist) durch das
  50 \fB$\fP\-Zeichen ersetzt.
  51
  52 Obwohl die Variablensubstitution bei allen Feldern der control\-Datei
  53 vorgenommen wird, werden einige dieser Felder während des Bauens benötigt
  54 und verwendet, wenn die Substitution noch nicht erfolgt ist. Daher können
  55 Sie Variablen nicht in den Feldern \fBPackage\fP, \fBSource\fP und \fBArchitecture\fP
  56 verwenden.
  57
  58 Variablenersetzung erfolgt am Inhalt der Felder, nachdem sie geparst
  59 (ausgewertet) wurden. Falls Sie eine Variable über mehrere Zeilen
  60 expandieren möchten, müssen Sie nach dem Zeilenumbruch daher kein
  61 Leerzeichen einfügen. Dies passiert bei der Ausgabe des Feldes implizit. Ist
  62 beispielsweise die Variable \fB${Description}\fP auf »foo ist bar.${Newline}foo
  63 ist super.« gesetzt und Sie haben das folgende Feld:
  64
  65  Description: foo application
  66   ${Description}
  67   .
  68   Weiterer Text.
  69
  70 Dann wird dies zu Folgenden führen:
  71
  72  Description: foo application
  73   foo ist bar.
  74   foo ist super.
  75   .
  76   Weiterer Text.
  77
  78 Variablen können über die allgemeine \fB\-V\fP\-Option gesetzt werden. Sie können
  79 auch in der \fBdebian/substvars\fP (bzw. in der über die Option \fB\-T\fP gesetzten
  80 Datei) angegeben werden. Diese Datei besteht auch Zeilen der Form
  81 \fIName\fP\fB=\fP\fIWert\fP. Leerraumzeichen am Zeilenende, leere Zeilen und Zeilen,
  82 die mit dem \fB#\fP\-Symbol starten (Kommentare) werden ignoriert.
  83
  84 Zusätzlich sind die folgenden Standardvariablen verfügbar:
  85 .TP
  86 \fBArch\fP
  87 Die aktuelle Host\-Architektur (d.h. die Architektur, für die das Paket
  88 gebaut wird, das Äquivalent zu \fBDEB_HOST_ARCH\fP).
  89 .TP
  90 \fBsource:Version\fP
  91 Die Quellpaketversion (seit Dpkg 1.13.19).
  92 .TP
  93 \fBsource:Upstream\-Version\fP
  94 Die Paketversion der Originalautoren, einschließlich der Epoche der
  95 Debian\-Version, falls vorhanden (seit Dpkg 1.13.19).
  96 .TP
  97 \fBbinary:Version\fP
  98 Die Binärpaketversion (die z.B. in einem binNMU von source:Version abweichen
  99 kann; seit Dpkg 1.13.19).
 100 .TP
 101 \fBSource\-Version\fP
 102 Die Quellpaketversion (aus der changelog\-Datei). Diese Variable ist jetzt
 103 \fBveraltet\fP und gibt bei der Benutzung einen Fehler aus, da ihre Bedeutung
 104 von ihrer Funktion abweicht, bitte verwenden Sie \fBsource:Version\fP oder
 105 \fBbinary:Version\fP wo zutreffend.
 106 .TP
 107 \fBInstalled\-Size\fP
 108 Die ungefähre Gesamtgröße der vom Paket installierten Dateien. Dieser Wert
 109 wird in das entsprechende Feld der »control«\-Datei kopiert; wird es gesetzt,
 110 verändert es den Wert dieses Feldes. Falls diese Variable nicht gesetzt ist,
 111 wird \fBdpkg\-gencontrol\fP den Vorgabewert berechnen, indem es die Größen jeder
 112 regulären Datei und jedes Symlinks (gerundet auf 1 KiB) aufsammelt und einen
 113 Grundwert von 1 KiB für aller anderen Dateisystemobjekttypen verwendet.
 114
 115 \fBHinweis\fP: Beachten Sie, dass dies stets nur ein Schätzwert sein kann, da
 116 die tatsächliche Größe im installierten System stark vom verwandten
 117 Dateisystem und seinen Parametern abhängt. Daher kann es am Ende mehr oder
 118 weniger als in diesem Feld angegebenen Platz belegen.
 119 .TP
 120 \fBExtra\-Size\fP
 121 Zusätzlicher Plattenplatz, der verwendet wird, wenn das Paket installiert
 122 ist. Falls diese Variable gesetzt ist, wird dieser Wert zu der
 123 \fBInstalled\-Size\fP\-Variablen hinzuaddiert (egal ob sie explizit gesetzt oder
 124 der Standardwert verwendet wird), bevor sie in das Feld \fBInstalled\-Size\fP
 125 der »control«\-Datei kopiert wird.
 126 .TP
 127 \fBS:\fP\fIFeldname\fP
 128 Der Wert des Quellpaket\-Absatzfeldes \fIFeldname\fP (der in der kanonischen
 129 Groß\-/Kleinschreibung angegeben werden muss; seit Dpkg 1.18.11). Das Setzen
 130 dieser Variablen hat nur an den Stellen einen Effekt, wo diese explizit
 131 expandiert werden. Diese Variablen sind nur bei der Erstellung der binären
 132 Steuerdatei verfügbar.
 133 .TP
 134 \fBF:\fP\fIFeldname\fP
 135 Der Wert des Ausgabefeldes \fIFeldname\fP (der in der kanonischen
 136 Groß\-/Kleinschreibung angegeben werden muss). Das Setzen dieser Variablen
 137 hat nur einen Effekt an den Stellen, wo diese explizit expandiert werden.
 138 .TP
 139 \fBFormat\fP
 140 Die Formatversion der \fB.changes\fP\-Datei, die von dieser Version der
 141 Quellpaketierskripte erstellt wird. Falls Sie diese Variable setzen, werden
 142 die Inhalte des \fBFormat\fP\-Feldes in der \fB.changes\fP\-Datei auch geändert.
 143 .TP
 144 \fBNewline\fP, \fBSpace\fP, \fBTab\fP
 145 Diese Variablen enthalten das jeweils korrespondieren Zeichen
 146 (\fBZeilenumbruch\fP, \fBLeerzeichen\fP und \fBTabulator\fP in dieser Reihenfolge).
 147 .TP
 148 \fBshlibs:\fP\fIdependencyfield\fP
 149 Variableneinstellungen mit Namen dieser Form werden von \fBdpkg\-shlibdeps\fP
 150 erstellt.
 151 .TP
 152 \fBdpkg:Upstream\-Version\fP
 153 Die Original\- (Upstream\-)Version von Dpkg (seit Dpkg 1.13.19).
 154 .TP
 155 \fBdpkg:Version\fP
 156 Die komplette Version von Dpkg (seit Dpkg 1.13.19).
 157 .LP
 158 Falls auf eine Variable Bezug genommen wird, diese aber nicht definiert ist,
 159 wird es eine Warnung erstellen und ein leerer Wert wird angenommen.
 160 .
 161 .SH DATEIEN
 162 .TP
 163 \fBdebian/substvars\fP
 164 Liste von Substitutionsvariablen und \-werten.
 165 .
 166 .SH "SIEHE AUCH"
 167 .ad l
 168 \fBdpkg\fP(1), \fBdpkg\-genchanges\fP(1), \fBdpkg\-gencontrol\fP(1),
 169 \fBdpkg\-shlibdeps\fP(1), \fBdpkg\-source\fP(1).
 170 .SH ÜBERSETZUNG
 171 Die deutsche Übersetzung wurde 2004, 2006-2017 von Helge Kreutzmann
 172 <debian@helgefjell.de>, 2007 von Florian Rehnisch <eixman@gmx.de> und
 173 2008 von Sven Joachim <svenjoac@gmx.de>
 174 angefertigt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die
 175 GNU General Public License Version 2 oder neuer für die Kopierbedingungen.
 176 Es gibt KEINE HAFTUNG.