NAME

       dh_install - installiert Dateien in Bauverzeichnisse von Paketen

ÜBERSICHT

       dh_install [-XElement] [--autodest] [--sourcedir=Verz] [Debhelper-Optionen]
       [Datei|Verz … Ziel]

BESCHREIBUNG

       dh_install ist ein Debhelper-Programm, das die Installation von Paketen in
       Bauverzeichnisse handhabt. Es gibt viele dh_install*-Befehle für die die Installation
       spezieller Dateitypen, wie Dokumentation, Beispiele, Handbuchseiten und so weiter und sie
       sollten nach Möglichkeit benutzt werden, da sie oft zusätzliche Programmlogik für diese
       besonderen Aufgaben mitbringen. Ergänzend eignet sich dh_install, um alles andere zu
       installieren, für das keine zusätzliche Logik benötigt wird. Es ist ein Ersatz für den
       alten Befehl dh_movefiles.

       Dieses Programm kann auf eine von zwei Arten benutzt werden. Falls Sie nur eine oder zwei
       Dateien haben, die das Makefile der Originalautoren nicht für Sie installiert, können Sie
       dh_install darüberlaufen lassen, um diese an Ort und Stelle zu verschieben. Vielleicht
       haben Sie auch ein großes Paket, das mehrere Binärpakete baut. Sie können dann das
       Makefile der Originalautoren nehmen, um alles in debian/tmp zu installieren und dann
       dh_install verwenden, um dann Dateien und Verzeichnisse in ihre passenden
       Paketbauverzeichnisse zu kopieren.

       Ab Debhelper-Kompatibilitätsstufe 7 wird dh_install in debian/tmp nach Dateien suchen,
       wenn es sie nicht im aktuellen Verzeichnis findet (oder wo auch immer Sie ihm mit
       --sourcedir aufgetragen haben, zu suchen).

DATEIEN

       debian/Paket.install
           Listet die Dateien auf, die in jedes Paket installiert werden und das Verzeichnis, in
           das sie installiert werden sollen. Das Format ist ein Satz von Zeilen, bei der jede
           Zeile eine oder mehrere zu installierende Dateien aufführt und am Zeilenende mitteilt,
           in welches Verzeichnis sie installiert werden sollen. Die Namen der Dateien (oder
           Verzeichnisse) sollten relativ zum aktuellen Verzeichnis angegeben werden, während das
           Installationsverzeichnis relativ zum Bauverzeichnis des Pakets angegeben wird. Sie
           können Platzhalter in den Namen der zu installierenden Dateien benutzen.

           Beachten Sie, falls Sie genau einen Dateinamen oder ein Platzhaltermuster allein auf
           einer Zeile ohne ein ausdrückliches Ziel aufführen, wird dh_install automatisch das
           Ziel abschätzen, sogar wenn dieser Schalter nicht gesetzt ist.

           unterstützt Ersetzungsvariablen in Kompatibilitätsstufe 13 oder neuer, wie in
           debhelper(7) beschrieben.

       debian/not-installed
           wird zusammen mit den missbilligten Optionen --list-missing und --fail-missing
           benutzt. Die Dokumentation dieser Datei finden Sie unter dh_missing(1).

OPTIONEN

       --list-missing
           Missbilligt: Bitte verwenden Sie stattdessen dh_missing --list-missing. Falls Sie
           diese Option verwenden, wird dh_install dh_missing mit dieser Option aufrufen, nachdem
           es alle Dateien verarbeitet hat. Die Dokumentation dieser Option finden Sie unter
           dh_missing(1).

           Die Option wurde in Kompatibilitätsstufe 12 entfernt.

       --fail-missing
           Missbilligt: Bitte verwenden Sie stattdessen dh_missing --fail-missing. Falls Sie
           diese Option verwenden, wird dh_install dh_missing mit dieser Option aufrufen, nachdem
           es alle Dateien verarbeitet hat. Die Dokumentation dieser Option finden Sie unter
           dh_missing(1).

           Die Option wurde in Kompatibilitätsstufe 12 entfernt.

       --sourcedir=Verz
           sucht im angegebenen Verzeichnis nach Dateien, die installiert werden sollen.

           Beachten Sie, dass dies nicht das Gleiche wie die Option --sourcedirectory ist, die
           von dh_auto_*-Befehlen benutzt wird. Sie benötigen diese Option selten, da dh_install
           in Debhelper-Kompatibilitätsstufe 7 und darüber automatisch in debian/tmp nach Dateien
           sucht.

       --autodest
           wird als Zielverzeichnis angenommen, um Dinge darin zu installieren. Falls dies
           angegeben wurde, sollten Sie keine Zielverzeichnisse in debian/Paket.install-Dateien
           oder auf der Befehlszeile festlegen. Stattdessen wird dh_install wie folgt raten:

           debian/tmp (oder das Quellverzeichnis, wenn eines angegeben ist) wird vom Anfang des
           Dateinamens entfernt, falls sie vorhanden ist, und wird in den Verzeichnisanteil des
           Dateinamens übernommen. Wenn also der Dateiname debian/tmp/usr/bin ist, dann wird
           dieses Verzeichnis nach debian/Paket/usr/ kopiert. Falls der Dateiname
           debian/tmp/etc/passwd ist, wird es nach debian/Paket/etc/ kopiert.

       <Datei|Verz … Zielverz
           listet zu installierende Dateien (oder Verzeichnisse) auf und wohin sie installiert
           werden sollen. Die Dateien werden in das erste Paket installiert, auf das sich
           dh_install auswirkt.

BEISPIELE

       Hier folgen einige kleine Beispiele für Konfigurationsdateien von dh_install.

           # installiert my-prog in usr/bin (als »usr/bin/mein_Programm«)
           my-prog usr/bin

           # installiert ein Erweiterungsverzeichnis in usr/share/mein_Programm
           # (als »usr/share/mein_Programm/plugins/«)
           plugins usr/share/mein_Programm

           # installiert eine Datei mit Leerzeichen in usr/share/mein_Programm/data
           # (als »usr/share/mein_Programm/data/meine_Daten mit spaces.txt«)
           # SETZT KOMPATIBILITÄTSSTUFE 13 VORAUS, in der Ersetzungsmuster
           # verfügbar sind
           my${Space}datafile${Space}with${Space}spaces.txt usr/share/mein_Programm/data

           # installiert eine Bibliothek in das Multiarch-Bibliotheksverzeichnis
           # SETZT KOMPATIBILITÄTSSTUFE 13 VORAUS, in der Ersetzungsmuster
           # verfügbar sind
           build/output/libfrop*.so.* usr/lib/${DEB_HOST_MULTIARCH}

EINSCHRÄNKUNGEN

       dh_install kann keine Dateien oder Verzeichnisse umbenennen, es kann sie nur mit den
       Namen, die sie bereits haben, im Paketbauverzeichnisbaum an die gewünschte Stelle
       installieren.

       Es gibt keine Möglichkeit, Ergebnisse basierend auf Bauprofilen oder Architektur
       auszufiltern. Ziehen Sie für Dokumentation die Verwendung von dh_installdocs oder
       dh_installexamples in Betracht, weil diese Hilfsprogramme für das Bauprofil nodoc
       zuständig sind.

       Umbenennung und Filterung kann jedoch durch Verwenden von dh-exec mit der
       Kompatibilitätsstufe 9 oder höher erreicht werden. Eine
       debian/package.install-Beispieldatei, die dh-exec verwendet, könnte wie folgt aussehen:

        #!/usr/bin/dh-exec
        debian/default.conf => /etc/my-package/start.conf
        build/foo /usr/bin <!pkg.bar.nofoo>

       Bitte vergessen Sie nicht die folgenden drei Dinge:

       •   Das Paket muss Kompatibilitätsstufe 9 oder höher verwenden (siehe debhelper(7)).

       •   Das Paket muss eine Bauabhängigkeit zu Dh-exec haben.

       •   Die Installationsdatei muss als ausführbar markiert sein.

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>