dh_installman(1) installiert Handbuchseiten in Paketbauverzeichnisse

ÜBERSICHT

dh_installman [Debhelper-Optionen] [Handbuchseite …]

BESCHREIBUNG

dh_installman ist ein Debhelper-Programm, das die Installation von Handbuchseiten an die korrekten Speicherorte in Paketbauverzeichnissen handhabt. Sie teilen ihm mit, welche Handbuchseiten in Ihr Paket kommen und es ergründet, wohin sie installiert werden, basierend auf dem Abschnittsfeld in ihrer .TH- oder .Dt-Zeile. Falls Sie eine ordentlich formatierte .TH- oder .Dt-Zeile haben, wird Ihre Handbuchseite in das richtige Verzeichnis mit dem richtigen Namen installiert (dies umfasst eine ordentliche Handhabung von Seiten mit einem Unterabschnitt wie 3perl, die in man3 platziert werden und Angabe einer Erweiterung von .3perl). Falls Ihre .TH- oder .Dt-Zeile nicht korrekt ist oder fehlt, wird das Programm möglicherweise aufgrund der Dateiendung falsch raten.

Es unterstützt außerdem übersetzte Handbuchseiten, indem es Endungen wie .ll.8 und .ll_LL.8 auswertet oder indem der Schalter --language benutzt wird.

Falls dh_installman eine Handbuchseite in den falschen Abschnitt oder mit der falschen Endung zu installieren scheint, ist dies, weil die Handbuchseite den falschen Abschnitt in ihrer .TH- oder .Dt-Zeile aufführt. Bearbeiten Sie die Handbuchseite, korrigieren Sie den Abschnitt und dh_installman wird passend folgen. Einzelheiten über die .TH-Zeile finden Sie in man(7) und über die .Dt-Zeile in mdoc(7). Falls dh_installman eine Handbuchseite in ein Verzeichnis wie /usr/share/man/pl/man1/ zu installieren scheint, ist dies, weil Ihr Programm einen Namen wie foo.pl hat und dh_installman annimmt, dass dies bedeutet, sie sei ins Polnische übersetzt. Benutzen Sie --language=C, um dies zu vermeiden.

Nach dem Installationsschritt für Handbuchseiten wird dh_installman prüfen, ob einige der Handbuchseiten in den temporären Verzeichnissen in irgendwelchen Paketen, auf die es sich auswirkt, .so-Links enthalten. Falls dies so ist, ändert es sie in symbolische Links.

dh_installman wird außerdem die Zeichenkodierung jeder Handbuchseite raten und sie in UTF-8 umwandeln. Falls das Raten aus irgend einem Grund fehlschlägt, können Sie sie außer Kraft setzen und eine Kodierungsangabe benutzen. Einzelheiten finden Sie unter manconv(1).

DATEIEN

debian/Paket.manpages
listet zu installierende Handbuchseiten auf.

OPTIONEN

-A, --all
installiert alle Dateien, die durch Befehlszeilenparameter in ALLEN Paketen angegeben werden, auf die es sich auswirkt.
--language=ll
Benutzen Sie dies, um anzugeben, dass die Handbuchseiten, auf die es sich auswirkt, in der angegebenen Sprache geschrieben sind.
Handbuchseite …>
installiert diese Handbuchseiten in das erste Paket, auf das es sich auswirkt (oder in allen Paketen, falls -A angegeben wurde).

ANMERKUNGEN

Eine ältere Version dieses Programms, dh_installmanpages(1), wird immer noch von einigen Paketen benutzt. Daher ist es immer noch in Debhelper enthalten. Es is jedoch veraltet, infolge seiner nicht eingängigen und uneinheitlichen Schnittstelle. Verwenden Sie stattdessen dieses Programm.

ÜBERSETZUNG

Diese Übersetzung wurde mit dem Werkzeug po4a <http://po4a.alioth.debian.org/> durch Chris Leick [email protected] und das deutsche Debian-Übersetzer-Team im Dezember 2011 erstellt.

Bitte melden Sie alle Fehler in der Übersetzung an [email protected] 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 <[email protected]>