NAME

       dh_installdocs - installiert Dokumentation in Paketbauverzeichnisse

ÜBERSICHT

       dh_installdocs [Debhelper-Optionen] [-A] [-XElement] [Datei …]

BESCHREIBUNG

       dh_installdocs ist ein Debhelper-Programm, das für die Installation von Dokumentation in
       usr/share/doc/Paket im Paketbauverzeichniszuständig ist.

DATEIEN

       debian/Paket.docs
           listet Dokumentationsdateien auf, die in Paket installiert werden sollen.

       debian/copyright
           Die  Copyright-Datei  ist  in  allen Paketen installiert, außer wenn eine speziellere Copyright-Datei
           verfügbar ist.

       debian/Paket.copyright
       debian/Paket.README.Debian
       debian/Paket.TODO
           Jede dieser Dateien wird automatisch installiert, falls sie für ein Paket vorhanden ist.

       debian/README.Debian
       debian/TODO
           Diese Dateien werden in das erste Binärpaket installiert, das in »debian/control« aufgeführt ist.

           Beachten Sie, dass README.debian-Dateien auch als README.Debian und  TODO-Dateien  in  nicht  nativen
           Paketen auch als TODO.Debian installiert werden.

       debian/Paket.doc-base
           sind  als  doc-base-Steuerdateien installiert. Beachten Sie, dass die Doc-ID vom Eintrag Document: in
           der bestreffenden Doc-base-Steuerdatei bestimmt wird. Im Fall, dass mehrere Doc-base-Dateien in einem
           einzelnen   Quellpaket    die    gleiche    Doc-ID    gemeinsam    benutzen,    werden    sie    nach
           usr/share/doc-base/package statt nach usr/share/doc-base/doc-id installiert.

       debian/Paket.doc-base.*
           Falls es nötig ist, dass Ihr Paket mehr als ein Dokument registriert, benötigen Sie mehrere Doc-base-
           Dateien  und  können sie so wie diese benennen. Im Fall, dass mehrere Doc-base-Dateien in diesem Stil
           in  einem  einzelnen  Quellpaket  die  gleiche   Doc-ID   gemeinsam   benutzen,   werden   sie   nach
           usr/share/doc-base/package-* statt nach usr/share/doc-base/doc-id installiert.

OPTIONEN

       -A, --all
           installiert alle Dateien, die durch Befehlszeilenparameter in ALLEN Paketen angegeben werden, auf die
           es sich auswirkt.

       -XElement, --exclude=Element
           schließt  Dateien  von der Installation aus, die Element in ihrem Dateinamen enthalten. Beachten Sie,
           dass dies doc-base-Dateien einschließt.

       --link-doc=Paket
           veranlasst,  dass  das  Dokumentationsverzeichnis  aller  Pakete,  auf  die  es  sich  auswirkt,  ein
           symbolischer  Link auf das Dokumentationsverzeichnis von Paket ist. Dies hat keine Auswirkungen, wenn
           auf das Paket selbst eingewirkt wird oder falls das Dokumentationsverzeichnis,  das  erstellt  werden
           soll, bereits bei der Ausführung von dh_installdocs existiert. Um der Richtlinie zu entsprechen, muss
           Paket ein Binärpaket sein, das vom selben Quellpaket stammt.

           Debhelper  wird  versuchen, die Installation von Dateien in verknüpfte Dokumentationsverzeichnisse zu
           verhindern, die Konflikte mit dem verknüpften Paket verursachen würden.  Die  Option  -A  wird  keine
           Auswirkungen auf Pakete mit verknüpften Dokumentationsverzeichnissen haben und die Dateien copyright,
           changelog, README.Debian und TODO werden nicht installiert.

           (Eine  ältere  Methode, um dasselbe zu erreichen, die immer noch unterstützt wird, besteht darin, das
           Dokumentationsverzeichnis  eines  Pakets  als  defekten  symbolischen  Link   zu   erstellen,   bevor
           dh_installdocs aufgerufen wird.)

           CAVEAT:  If  a previous version of the package was built without this option and is now built with it
           (or vice-versa), it requires a "dir to symlink" (or "symlink to dir") migration. Since debhelper  has
           no knowledge of previous versions, you have to enable this migration itself.

           Dies  kann  durch  Bereitstellen  einer »debian/Paket.maintscript«-Datei und mittels dh_installdeb(1)
           erledigt werden. Dadurch werden die passenden Betreuerskriptschnipsel zur Verfügung gestellt.

       <Datei …
           installiert diese Dateien als Dokumentation in das erste Paket, auf die es  sich  auswirkt  (oder  in
           allen Paketen, falls -A angegeben wurde).

BEISPIELE

       Dies ist ein Beispiel einer debian/Paket.docs-Datei:

         README
         TODO
         debian/notes-for-maintainers.txt
         docs/manual.txt
         docs/manual.pdf
         docs/manual-html/

ANMERKUNGEN

       Beachten  Sie,  dass  dh_installdocs klaglos ganze Verzeichnishierarchien kopiert, falls Sie es verlangen
       (ähnlich cp -a). Falls verlangt wurde, ein Verzeichnis zu installieren, wird es den kompletten Inhalt des
       Verzeichnisses installieren.

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>

9.20160115ubuntu3                                  2016-03-31                                  DH_INSTALLDOCS(1)