.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLDEBCONF 1"
.TH DH_INSTALLDEBCONF 1 2024-03-27 13.15.3 Debhelper
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
dh_installdebconf \- installiert Dateien, die von Debconf im Paketbauverzeichnis benutzt werden
.SH ÜBERSICHT
.IX Header "ÜBERSICHT"
\&\fBdh_installdebconf\fR [\fIDebhelper-Optionen\fR] [\fB\-n\fR] [\fB\-\-\fR\ \fIParameter\fR]
.SH BESCHREIBUNG
.IX Header "BESCHREIBUNG"
\&\fBdh_installdebconf\fR ist ein Debhelper-Programm, das dafür zuständig ist, die Dateien, die von Debconf verwendet werden, in die Paketbauverzeichnisse zu installieren.
.PP
Es erzeugt außerdem automatisch die für die Verbindung mit Debconf nötigen \fIpostrm\fR\-Befehle. \fBdh_installdeb\fR trägt die Befehle in die Betreuerskripte ein. Eine Erklärung, wie das funktioniert, finden Sie in \fBdh_installdeb\fR\|(1).
.PP
Beachten Sie, dass, falls Sie Debconf benutzen, Ihr Paket wahrscheinlich davon abhängen muss (es wird durch dieses Programm zu \fB${misc:Depends}\fR hinzugefügt).
.PP
Beachten Sie für Ihr durch \fBdpkg\fR aufgerufenes Konfigurationsskript, dass Ihr \fIpostinst\fR das Confmodul von Debconf einbinden muss. \fBdh_installdebconf\fR installiert die benötigten Befehle nicht automatisch in \fIpostinst\fR, da es zu schwierig ist, dies richtig zu machen.
.SH DATEIEN
.IX Header "DATEIEN"
.IP debian/\fIPaket\fR.config 4
.IX Item "debian/Paket.config"
Dies ist das Debconf\-\fIconfig\fR\-Skript. Es ist im Verzeichnis \fIDEBIAN\fR im Paketbauverzeichnis installiert.
.Sp
Innerhalb des Skripts wird die Markierung \fB#DEBHELPER#\fR durch Shell-Skriptschnipsel ersetzt, die durch andere Debhelper-Befehle erzeugt wurden.
.IP debian/\fIPaket\fR.template 4
.IX Item "debian/Paket.template"
Dies ist die Debconf\-\fItemplates\fR\-Datei. Sie ist im Verzeichnis \fIDEBIAN\fR im Paketbauverzeichnis installiert.
.IP \fIdebian/po/\fR 4
.IX Item "debian/po/"
Falls dieses Verzeichnis vorhanden ist, wird dieses Programm automatisch \fBpo2debconf\fR\|(1) benutzen, um zusammengefügte Schablonendateien zu erzeugen, die Übersetzungen aus dem Verzeichnis enthalten.
.Sp
Für diese Aufgabe sollte Ihr Paket über eine Bauabhängigkeit auf \fIpo-debconf\fR verfügen.
.SH OPTIONEN
.IX Header "OPTIONEN"
.IP "\fB\-n\fR, \fB\-\-no\-scripts\fR" 4
.IX Item "-n, --no-scripts"
Ncht das \fIpostrm\fR\-Skript ändern.
.IP "\fB\-\-\fR \fIParameter\fR" 4
.IX Item "-- Parameter"
Übergeben der Parameter an \fBpo2debconf\fR.
.IP "\fB\-D\fR\fIMARKIERUNG=WERT\fR, \fB\-\-define\fR \fIMARKIERUNG=WERT\fR" 4
.IX Item "-DMARKIERUNG=WERT, --define MARKIERUNG=WERT"
definiert Markierungen, die innerhalb von Betreuerskripten bei ihrer Erzeugung ersetzt werden. Bitte beachten Sie, dass die in "Beschränkungen in Markierungsnamen" beschriebenen Beschränkungen auch für Markierungen gelten, die auf der Befehlszeile definiert werden. Ungültige Markierungsnamen werden einen Fehler auslösen.
.Sp
In einfachen Fall wird dieser Parameter veranlassen, dass \fB#\fR\f(BIMARKIERUNG\fR\fB#\fR durch \fIWERT\fR ersetzt wird. Falls \fIWERT\fR mit einem \fI@\fR\-Zeichen beginnt, wird von \fIWERT\fR erwartet, dass er auf eine Datei zeigt, die den tatsächlich einzufügenden Wert enthält.
.Sp
Eine explizit mit diesem Parameter deklarierte Markierung wird die eingebauten Markierungen ersetzen.
.Sp
Testbeispiele zum besseren Verständnis:
.Sp
.Vb 6
\&        cat >> debian/config <<EOF
\&        #EINFACH#
\&        #DATEIBASIERT#
\&        EOF
\&        echo \-n "Komplexer Wert" > irgendeine\-Datei
\&    dh_installdeb \-\-define EINFACH=direkt \-\-define DATEIBASIERT=@irgendeine\-Datei
.Ve
.Sp
In diesem Beispiel wird \fB#EINFACH#\fR zu \fBdirekt\fR und \fB#DATEIBASIERT#\fR zu \fBKomplexer Wert\fR expandiert.
.Sp
Es ist auch möglich, paketspezifische Werte für eine angegebene Markierung zu setzen, was hilfreich ist, wenn \fBdh_installdeb\fR mit mehreren Paketen agiert, die unterschiedliche Werte für dieselbe Markierung benötigen. Dazu wird \fBpkg.\fR\f(BIPaketname\fR\fB.\fR vor die Markierung gestellt.
.Sp
Es kann wie im folgenden Beispiel benutzt werden:
.Sp
.Vb 10
\&        cat >> debian/foo.config <<EOF
\&        # Skript für #PACKAGE#
\&        #MARKIERUNG#
\&        EOF
\&        cat >> debian/bar.config <<EOF
\&        # Skript für #PACKAGE#
\&        #MARKIERUNG#
\&        EOF
\&        cat >> debian/baz.config <<EOF
\&        # Skript für #PACKAGE#
\&        #MARKIERUNG#
\&        EOF
\&    dh_installdeb \-pfoo \-pbar \-pbaz  \-\-define MARKIERUNG=Vorgabe \-\-define pkg.bar.MARKIERUNG=eindeutiger\-bar\-wert \e
\&      \-\-define pkg.baz.MARKIERUNG=eindeutiger\-baz\-wert
.Ve
.Sp
In diesem Beispiel wird \fB#MARKIERUNG#\fR in \fIdebian/foo.config\fR zu \fBVorgabe\fR, in \fIdebian/bar.config\fR zu \fBeindeutiger-bar-wert\fR und in \fIdebian/baz.config\fR zu \fBeindeutiger-baz-wert\fR expandiert.
.Sp
Beachten Sie, dass die \fB#pkg.*#\fR\-Markierungen in allen Skripten, mit denen gearbeitet wird, sichtbar sind. Sie können sich z. B. auf \fB#pkg.bar.MARKIERUNG#\fR innerhalb von \fIdebian/foo.config\fR beziehen und es wird durch \fBeindeutiger-bar-wert\fR ersetzt.
.SH "ERSETZUNG IN BETREUERSKRIPTEN"
.IX Header "ERSETZUNG IN BETREUERSKRIPTEN"
\&\fBdh_installdeb\fR wird automatisch die folgenden Markierungen innerhalb eines bereitgestellten Betreuerskripts ersetzen (falls sie nicht über \fB\-D\fR/\fB\-\-define\fR ersetzt werden):
.IP "#DEB_HOST_\fINAME\fR#, #DEB_BUILD_\fINAME\fR#, #DEB_TARGET_\fINAME\fR#" 4
.IX Item "#DEB_HOST_NAME#, #DEB_BUILD_NAME#, #DEB_TARGET_NAME#"
Diese Markierungen werden durch die entsprechende Variable aus \fBdpkg\-architecture\fR\|(1) ersetzt. In fast allen Fällen werden Sie die Variante \fB#DEB_HOST_\fR\f(BINAME\fR in einem Skript benutzen wollen, um sicherzustellen, dass Sie beim Cross-Bauen den richtigen Wert haben.
.Sp
Wenn Markierungen dieses Musters auch unter größten Anstrengungen nicht zu einer Variable in \fBdpkg\-architecture\fR\|(1) passen, werden sie so belassen, wie sie sind.
.IP #ENV.\fINAME\fR# 4
.IX Item "#ENV.NAME#"
Markierungen dieser Form werden durch den Wert der entsprechenden Umgebungsvariable ersetzt. Falls eine Umgebungsvariable nicht gesetzt ist, wird die Markierung durch die leere Zeichenkette ersetzt.
.Sp
Beachten Sie, dass es Einschränkungen gibt, welche Namen verwendet werden können (siehe "Einschränkungen in Markierungsnamen").
.IP #PACKAGE# 4
.IX Item "#PACKAGE#"
Diese Markierung wird standardmäßig durch den Namen des Paketes ersetzt, welches das wirkliche Skript enthält.
.SS "Einschränkungen in Markierungsnamen"
.IX Subsection "Einschränkungen in Markierungsnamen"
Alle Markierungen, die zur Ersetzung vorgesehen sind, müssen zum regulären Ausdruck #[A\-Za\-z0\-9_.+]+# passen.
.PP
Markierungen, die nicht auf diesen Ausdruck passen, werden stillschweigend ignoriert, falls sie in der Skriptschablone gefunden werden. Ungültige Markierungsnamen, die per \fB\-D\fR oder \fB\-\-define\fR übergeben wurden, führen in den meisten Fällen dazu, dass \fBdh_installdebconf\fR den Befehl mit einem Fehler zurückweist.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBdebhelper\fR\|(7)
.PP
Dieses Programm ist Teil von Debhelper.
.SH ÜBERSETZUNG
.IX Header "ÜBERSETZUNG"
Diese Übersetzung wurde mit dem Werkzeug
\&\fBpo4a\fR
<http://po4a.alioth.debian.org/>
durch Chris Leick
\&\fIc.leick@vollbio.de\fR
und das deutsche Debian\-Übersetzer\-Team im 
Dezember 2011 erstellt.
.PP
Bitte melden Sie alle Fehler in der Übersetzung an
\&\fIdebian\-l10n\-german@lists.debian.org\fR
oder als Fehlerbericht an das Paket
\&\fIdebhelper\fR.
.PP
Sie können mit dem folgenden Befehl das englische 
Original anzeigen
man\ \-L\ en\ Abschnitt\ Handbuchseite
.SH AUTOR
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>