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.
- debian/Paket.doc-base.*
- Falls Ihr Paket mehr als ein Dokument registrieren muss,
benötigen Sie mehrere doc-base-Dateien und können sie so
benennen.
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 Verweis 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 Verweis zu erstellen, bevor
dh_installdocs aufgerufen wird.)
- <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.
Beachten Sie, dass dieser Befehl nicht idempotent ist. Zwischen Aufrufen dieses
Befehls sollte
dh_prep(1) aufgerufen werden. Ansonsten könnte er
zur Folge haben, dass den Betreuerskripten mehrere Instanzen des gleichen
Textes hinzugefügt werden.
SIEHE AUCH¶
debhelper(7)
Dieses Programm ist Teil von Debhelper.
TRADUCTION¶
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 section page_de_man
AUTOR¶
Joey Hess <joeyh@debian.org>