Commit | Line | Data |
---|---|---|
1479465f GJ |
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. |