
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 BEZEICHNUNG

deb-substvars - Ersetzungsvariablen in Debian-Quellen

=head1 ÜBERSICHT

B<debian/substvars>, B<debian/>I<binary-package>B<.substvars>, Variablen

=head1 BESCHREIBUNG

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

=head2 Variablen-Syntax

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

=head2 Dateisyntax

Substitution variables can be specified in a file.  These files consist of lines with variable assignments, that start with the variable name, immediately followed by an assignment operator, and then the value.  Each operator gives the variable specific attributes.  Trailing whitespace on each line, blank lines, and lines starting with a B<#> symbol (comments) are ignored.

The following operators are supported:

=over 

=item B<=>

Assigns a normal substitution variable.

=item B<?=>

Assigns an optional substitution variable which will emit no warnings even if unused.

Supported since dpkg 1.21.8.

=item B<!=>

Assigns a required substitution variable which will error out if unused.

Supported since dpkg 1.22.7.

=item B<$=>

Assigns an implicit substitution variable which will get automatically instantiated as a field, if that field is not defined for B<.dsc> and B<.deb> control files.

The variable name needs to be formed as a namespace followed by a colon (‘B<:>’) and then the field name, such as B<tool:Depends>.  All implicit variables for any namespace matching the same field will get concatenated using a known field separator, or a space if the field separator is unknown.

Supported since dpkg 1.23.0.

=back

For example C<some-package:Depends?=other-package (= 1.0), the-package>.

=head2 Ersetzungen

Variablen können über die allgemeine Option B<-V> gesetzt werden. Sie können auch in der B<debian/substvars> (bzw. in der über die allgemeine Option B<-T> gesetzten Datei) angegeben werden.

Nachdem alle Ersetzungen erfolgt sind, wird jedes Auftreten der Zeichenkette B<${}> (die keine tatsächliche Ersetzungsvariable ist) durch das B<$>-Zeichen ersetzt. Dies kann als Maskiersequenz wie in B<${}{>I<VARIABLE>B<}> verwandt werden, was dann zu B<${>I<VARIABLE>B<}> in der Ausgabe wird.

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

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

Variablenersetzung erfolgt am Inhalt der Felder, nachdem sie 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 B<${Description}> auf „foo ist bar.${Newline}foo ist super.“ gesetzt und Sie haben das folgende Feld:

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

Dann wird dies zu Folgenden führen:

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

=head2 Eingebaute Variable

Zusätzlich sind die folgenden Standardvariablen immer verfügbar:

=over 

=item B<Arch>

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

=item B<vendor:Name>

Der aktuelle Lieferantenname (seit Dpkg 1.20.0). Dieser Wert stammt aus dem Feld B<Vendor> aus der Datei »origin« des Lieferanten, wie dies von L<dpkg-vendor(1)> ermittelt würde.

=item B<vendor:Id>

Die aktuelle Lieferantenkennzeichnung (seit Dpkg 1.20.0). Die ist lediglich B<vendor:Name> in Kleinbuchstaben.

=item B<source:Version>

Die Quellpaketversion (seit Dpkg 1.13.19).

=item B<source:Upstream-Version>

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

=item B<binary:Version>

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

=item B<Source-Version>

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

=item B<source:Synopsis>

Die Quellpaketzusammenfassung, aus dem Feld B<Description> des Quellabsatzes entnommen, falls dieses existiert (seit Dpkg 1.19.0).

=item B<source:Extended-Description>

Die erweiterte Quellpaketbeschreibung, aus dem Feld B<Description> des Quellabsatzes entnommen, falls dieses existiert (seit Dpkg 1.19.0).

=item B<Installed-Size>

Die ungefähre Gesamtgröße der vom Paket installierten Dateien. Dieser Wert wird in das entsprechende Feld der B<control>-Datei kopiert; wird es gesetzt, verändert es den Wert dieses Feldes. Falls diese Variable nicht gesetzt ist, wird B<dpkg-gencontrol> den Vorgabewert berechnen, indem es die Größen jeder regulären Datei und jedes Symlinks (gerundet auf 1 KiB) aufaddiert und einen Grundwert von 1 KiB für aller anderen Dateisystemobjekttypen verwendet. Dabei werden Hardlinks nur einmalig als reguläre Dateien gezählt.

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

=item B<Extra-Size>

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

=item B<S:>I<Feldname>

Der Wert des Quellpaket-Absatzfeldes I<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.

=item B<F:>I<Feldname>

Der Wert des Ausgabefeldes I<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.

=item B<Format>

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

=item B<Newline>, B<Space>, B<Tab>

Diese Variablen enthalten das jeweils korrespondiere Zeichen (B<Zeilenumbruch>, B<Leerzeichen> und B<Tabulator> in dieser Reihenfolge).

=item B<shlibs:>I<dependencyfield>

Variableneinstellungen mit Namen dieser Form werden von B<dpkg-shlibdeps> erstellt.

=item B<dpkg:Upstream-Version>

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

=item B<dpkg:Version>

Die komplette Version von Dpkg (seit Dpkg 1.13.19).

=back

=head1 DATEIEN

=over 

=item B<debian/substvars>

Liste von Ersetzungsvariablen und -werten.

=back

=head1 SIEHE AUCH

L<dpkg(1)>, L<dpkg-vendor(1)>, L<dpkg-genchanges(1)>, L<dpkg-gencontrol(1)>, L<dpkg-shlibdeps(1)>, L<dpkg-source(1)>.


=head1 ÜBERSETZUNG

Die deutsche Übersetzung wurde 2004, 2006-2025 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.
