NAME

       dh_installdebconf - installiert Dateien, die von Debconf im Paketbauverzeichnis benutzt
       werden

ÜBERSICHT

       dh_installdebconf [Debhelper-Optionen] [-n] [-- Parameter]

BESCHREIBUNG

       dh_installdebconf ist ein Debhelper-Programm, das dafür zuständig ist, die Dateien, die
       von Debconf verwendet werden, in die Paketbauverzeichnisse zu installieren.

       Es erzeugt außerdem automatisch die für die Verbindung mit Debconf nötigen postrm-Befehle.
       dh_installdeb trägt die Befehle in die Betreuerskripte ein. Eine Erklärung, wie das
       funktioniert, finden Sie in dh_installdeb(1).

       Beachten Sie, dass, falls Sie Debconf benutzen, Ihr Paket wahrscheinlich davon abhängen
       muss (es wird durch dieses Programm zu ${misc:Depends} hinzugefügt).

       Beachten Sie für Ihr durch dpkg aufgerufenes Konfigurationsskript, dass Ihr postinst das
       Confmodul von Debconf einbinden muss. dh_installdebconf installiert die benötigten Befehle
       nicht automatisch in postinst, da es zu schwierig ist, dies richtig zu machen.

DATEIEN

       debian/Paket.config
           Dies ist das Debconf-config-Skript. Es ist im Verzeichnis DEBIAN im
           Paketbauverzeichnis installiert.

           Innerhalb des Skripts wird die Markierung #DEBHELPER# durch Shell-Skriptschnipsel
           ersetzt, die durch andere Debhelper-Befehle erzeugt wurden.

       debian/Paket.template
           Dies ist die Debconf-templates-Datei. Sie ist im Verzeichnis DEBIAN im
           Paketbauverzeichnis installiert.

       debian/po/
           Falls dieses Verzeichnis vorhanden ist, wird dieses Programm automatisch po2debconf(1)
           benutzen, um zusammengefügte Schablonendateien zu erzeugen, die Übersetzungen aus dem
           Verzeichnis enthalten.

           Für diese Aufgabe sollte Ihr Paket über eine Bauabhängigkeit auf po-debconf verfügen.

OPTIONEN

       -n, --no-scripts
           Nicht das postrm-Skript ändern.

       -- Parameter
           Übergeben der Parameter an po2debconf.

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

           In einfachen Fall wird dieser Parameter veranlassen, dass #MARKIERUNG# durch WERT
           ersetzt wird. Falls WERT mit einem @-Zeichen beginnt, wird von WERT erwartet, dass er
           auf eine Datei zeigt, die den tatsächlich einzufügenden Wert enthält.

           Eine explizit mit diesem Parameter deklarierte Markierung wird die eingebauten
           Markierungen ersetzen.

           Testbeispiele zum besseren Verständnis:

                   cat >> debian/config <<EOF
                   #EINFACH#
                   #DATEIBASIERT#
                   EOF
                   echo -n "Komplexer Wert" > irgendeine-Datei
               dh_installdeb --define EINFACH=direkt --define DATEIBASIERT=@irgendeine-Datei

           In diesem Beispiel wird #EINFACH# zu direkt und #DATEIBASIERT# zu Komplexer Wert
           expandiert.

           Es ist auch möglich, paketspezifische Werte für eine angegebene Markierung zu setzen,
           was hilfreich ist, wenn dh_installdeb mit mehreren Paketen agiert, die
           unterschiedliche Werte für dieselbe Markierung benötigen. Dazu wird pkg.Paketname. vor
           die Markierung gestellt.

           Es kann wie im folgenden Beispiel benutzt werden:

                   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 \
                 --define pkg.baz.MARKIERUNG=eindeutiger-baz-wert

           In diesem Beispiel wird #MARKIERUNG# in debian/foo.config zu Vorgabe, in
           debian/bar.config zu eindeutiger-bar-wert und in debian/baz.config zu eindeutiger-baz-
           wert expandiert.

           Beachten Sie, dass die #pkg.*#-Markierungen in allen Skripten, mit denen gearbeitet
           wird, sichtbar sind. Sie können sich z. B. auf #pkg.bar.MARKIERUNG# innerhalb von
           debian/foo.config beziehen und es wird durch eindeutiger-bar-wert ersetzt.

ERSETZUNG IN BETREUERSKRIPTEN

       dh_installdeb wird automatisch die folgenden Markierungen innerhalb eines bereitgestellten
       Betreuerskripts ersetzen (falls sie nicht über -D/--define ersetzt werden):

       #DEB_HOST_NAME#, #DEB_BUILD_NAME#, #DEB_TARGET_NAME#
           Diese Markierungen werden durch die entsprechende Variable aus dpkg-architecture(1)
           ersetzt. In fast allen Fällen werden Sie die Variante #DEB_HOST_NAME in einem Skript
           benutzen wollen, um sicherzustellen, dass Sie beim Cross-Bauen den richtigen Wert
           haben.

           Wenn Markierungen dieses Musters auch unter größten Anstrengungen nicht zu einer
           Variable in dpkg-architecture(1) passen, werden sie so belassen, wie sie sind.

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

           Beachten Sie, dass es Einschränkungen gibt, welche Namen verwendet werden können
           (siehe "Einschränkungen in Markierungsnamen").

       #PACKAGE#
           Diese Markierung wird standardmäßig durch den Namen des Paketes ersetzt, welches das
           wirkliche Skript enthält.

   Einschränkungen in Markierungsnamen
       Alle Markierungen, die zur Ersetzung vorgesehen sind, müssen zum regulären Ausdruck
       #[A-Za-z0-9_.+]+# passen.

       Markierungen, die nicht auf diesen Ausdruck passen, werden stillschweigend ignoriert,
       falls sie in der Skriptschablone gefunden werden. Ungültige Markierungsnamen, die per -D
       oder --define übergeben wurden, führen in den meisten Fällen dazu, dass dh_installdebconf
       den Befehl mit einem Fehler zurückweist.

SIEHE AUCH

       debhelper(7)

       Dieses Programm ist Teil von Debhelper.

ÜBERSETZUNG

       Diese Übersetzung wurde mit dem Werkzeug po4a <http://po4a.alioth.debian.org/> durch Chris
       Leick c.leick@vollbio.de und das deutsche Debian-Übersetzer-Team im Dezember 2011
       erstellt.

       Bitte melden Sie alle Fehler in der Übersetzung an debian-l10n-german@lists.debian.org
       oder als Fehlerbericht an das Paket debhelper.

       Sie können mit dem folgenden Befehl das englische Original anzeigen
       man -L en Abschnitt Handbuchseite

AUTOR

       Joey Hess <joeyh@debian.org>