In Kompatibilitätsstufe 10 und älter war dh_install(1) möglicherweise ein besseres Werkzeug zur Handhabung von Dokumentation der Ursprungsautoren, wenn das eigene Bausystem der Ursprungsautoren sämtliche gewünschte Dokumentation korrekt installierte. In diesem Fall ist dh_installdocs immer noch nützlich, um paketierungsbezogene Dokumentation (z.B. die Datei debian/copyright) zu installieren.
Ab Debhelper-Kompatibilitätsstufe 11 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).
In Kompatibilitätsstufe 11 und neuer bietet dh_installdocs viele der Funktionalitäten, die auch dh_install(1) hat. Desweiteren unterstützt dh_installdocs außerdem das Bauprofil nodoc, um Dokumentation (unabhängig von der Kompatibilitätsstufe) auszuschließen.
Beachten Sie, dass README.debian-Dateien auch als README.Debian und TODO-Dateien in nicht nativen Paketen auch als TODO.Debian installiert werden.
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_installman in Debhelper-Kompatibilitätsstufe 11 und darüber automatisch in debian/tmp nach Dateien sucht.
In Kompatibilitätsstufe 11 (oder höher) ist diese Option nur dann nützlich, falls Debhelpers automatische Erkennung des Hauptpakets falsch ist. Die Option kann außerdem benutzt werden, um eine Warnung von Debhelper zum Schweigen zu bringen, wenn die automatische Erkennung fehlschlägt, die Voreinstellung aber korrekt funktioniert.
Diese Option kann nicht verwendet werden, wenn dh_installdocs angewiesen wurde, auf mehrere Pakete einzuwirken. Falls Sie diese Option benötigen, werden Sie sie üblicherweise mit -p kombinieren müssen, um sicherzustellen, dass nur auf exakt ein Paket eingewirkt wird.
Bitte denken Sie daran, dass manche Dokumentation (die Copyright-Datei, README.Debian, etc.) nicht von dieser Option beeinflusst wird.
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.)
Bitte beachten Sie, dass diese Option nur für das Dokumentationsverzeichnis des Pakets selbst gilt. Wenn das Paket Dokumentation für ein anderes Paket mitbringt (siehe z.B. --doc-main-package), wird es keinen symbolischen Link für die Dokumentation des anderen Pakets verwenden.
WARNUNG 1: Falls eine vorhergehende Version des Pakets ohne diese Option gebaut wurde und nun mit ihr gebaut wird (oder umgekehrt), erfordert es eine »Verzeichnis-zu-symbolischem-Link-Migration (oder »symbolischer-Link-zu-Verzeichnis«). Da Debhelper nichts von vorhergehenden Versionen weiß, müssen Sie diese Migration selbst anstoßen.
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.
WARNUNG 2: --link-doc sollte nur benutzt werden, wenn die Pakete denselben »architecture«-Typ haben. Ein Link von einem architekturunabhängigen zu einem architekturabhängigen Paket (oder umgekehrt) wird nicht funktionieren. Seit Kompatibilitätsstufe 10 wird Debhelper nicht unterstützte Kombinationen aktiv zurückweisen.
README TODO debian/notes-for-maintainers.txt docs/manual.txt docs/manual.pdf docs/manual-html/
Dieses Programm ist Teil von Debhelper.
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