.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings. \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote. \*(C+ will
.\" give a nicer C++. Capital omega is used to do unbreakable dashes and
.\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
. ds -- \(*W-
. ds PI pi
. if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
. if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
. ds L" ""
. ds R" ""
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds -- \|\(em\|
. ds PI \(*p
. ds L" ``
. ds R" ''
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH_INSTALLMAN 1"
.TH DH_INSTALLMAN 1 "2019-02-23" "12.1.1" "Debhelper"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
dh_installman \- installiert Handbuchseiten in Paketbauverzeichnisse
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
\&\fBdh_installman\fR [\fIDebhelper-Optionen\fR] [\fIHandbuchseite\fR …]
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBdh_installman\fR ist ein Debhelper-Programm, das die Installation von
Handbuchseiten an korrekten Stellen in Paketbauverzeichnissen handhabt.
.PP
In Kompatibilitätsstufe 10 und älter war dieses Programm in erster Linie
dafür da, wenn das Bausystem der Ursprungsautoren sie nicht ordentlich als
Teil ihres Installationsschritts installierte (oder keinen
Installationsschritt hatte). In Kompatibilitätsstufe 11 und höher
unterstützt es dieselben Funktionalitäten wie \fBdh_install\fR\|(1) und hat den
Vorteil, dass es (im Gegensatz zu \fBdh_install\fR\|(1)) das Bauprofil \fBnodoc\fR
beachtet.
.PP
Sogar wenn Sie die Verwendung von \fBdh_install\fR\|(1) für das Installieren der
Handbuchseiten vorziehen, kann \fBdh_installman\fR immer noch nützlich (wie
unten beschreiben) sein für die Umwandlung der Handbuchseitenkodierung in
\&\s-1UTF\-8\s0 und die Umwandlung von \fI.so\fR\-Links . Dieser Teil geschieht jedoch
ohne ausdrückliche Konfiguration automatisch.
.PP
Sie teilen \fBdh_installman\fR mit, welche Handbuchseiten in Ihr Paket kommen
und es ergründet, wohin sie installiert werden, basierend auf dem
Abschnittsfeld in ihrer \fB.TH\fR\- oder \fB.Dt\fR\-Zeile. Falls Sie eine ordentlich
formatierte \fB.TH\fR\- oder \fB.Dt\fR\-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 \fB3perl\fR, die
in \fIman3\fR platziert werden und Angabe einer Erweiterung von
\&\fI.3perl\fR). Falls Ihre \fB.TH\fR\- oder \fB.Dt\fR\-Zeile nicht korrekt ist oder
fehlt, wird das Programm möglicherweise aufgrund der Dateiendung falsch
raten.
.PP
Es unterstützt außerdem übersetzte Handbuchseiten, indem es Endungen wie
\&\fI.ll.8\fR und \fI.ll_LL.8\fR auswertet oder indem der Schalter \fB\-\-language\fR
benutzt wird.
.PP
Falls \fBdh_installman\fR eine Handbuchseite in den falschen Abschnitt oder mit
der falschen Endung zu installieren scheint, ist dies, weil die
Handbuchseite den falschen Abschnitt in ihrer \fB.TH\fR\- oder \fB.Dt\fR\-Zeile
aufführt. Bearbeiten Sie die Handbuchseite, korrigieren Sie den Abschnitt
und \fBdh_installman\fR wird passend folgen. Einzelheiten über die \fB.TH\fR\-Zeile
finden Sie in \fBman\fR\|(7) und über die \fB.Dt\fR\-Zeile in \fBmdoc\fR\|(7). Falls
\&\fBdh_installman\fR eine Handbuchseite in ein Verzeichnis wie
\&\fI/usr/share/man/pl/man1/\fR zu installieren scheint, ist dies, weil Ihr
Programm einen Namen wie \fIfoo.pl\fR hat und \fBdh_installman\fR annimmt, dass
dies bedeutet, sie sei ins Polnische übersetzt. Benutzen Sie
\&\fB\-\-language=C\fR, um dies zu vermeiden.
.PP
Nach dem Installationsschritt für Handbuchseiten wird \fBdh_installman\fR
prüfen, ob einige der Handbuchseiten in den temporären Verzeichnissen in
irgendwelchen Paketen, auf die es sich auswirkt, \fI.so\fR\-Links
enthalten. Falls dies so ist, ändert es sie in symbolische Links.
.PP
\&\fBdh_installman\fR wird außerdem die Zeichenkodierung jeder Handbuchseite
raten und sie in \s-1UTF\-8\s0 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 \fBmanconv\fR\|(1).
.PP
From debhelper compatibility level 11 on, \fBdh_install\fR will fall back to
looking in \fIdebian/tmp\fR for files, if it does not find them in the current
directory (or wherever you've told it to look using \fB\-\-sourcedir\fR).
.SH "DATEIEN"
.IX Header "DATEIEN"
.IP "debian/\fIPaket\fR.manpages" 4
.IX Item "debian/Paket.manpages"
listet zu installierende Handbuchseiten auf.
.SH "OPTIONEN"
.IX Header "OPTIONEN"
.IP "\fB\-A\fR, \fB\-\-all\fR" 4
.IX Item "-A, --all"
installiert alle Dateien, die durch Befehlszeilenparameter in \s-1ALLEN\s0 Paketen
angegeben werden, auf die es sich auswirkt.
.IP "\fB\-\-language=\fR\fIll\fR" 4
.IX Item "--language=ll"
Benutzen Sie dies, um anzugeben, dass die Handbuchseiten, auf die es sich
auswirkt, in der angegebenen Sprache geschrieben sind.
.IP "\fB\-\-sourcedir=\fR\fIVerz\fR" 4
.IX Item "--sourcedir=Verz"
schaut im angegebenen Verzeichnis nach Dateien, die installiert werden
sollen. Diese Option erfordert Kompatibilitätsstufe 11 oder höher (sie wird
in Kompatibilitätsstufe 10 und darunter stillschweigend ignoriert).
.Sp
Beachten Sie, dass dies nicht das Gleiche wie die Option
\&\fB\-\-sourcedirectory\fR ist, die von \fBdh_auto_\fR\fI*\fR\-Befehlen benutzt wird. Sie
benötigen diese Option selten, da \fBdh_installman\fR in
Debhelper\-Kompatibilitätsstufe 11 und darüber automatisch in \fIdebian/tmp\fR
nach Dateien sucht.
.IP "\fIHandbuchseite\fR …>" 4
.IX Item "Handbuchseite …>"
installiert diese Handbuchseiten in das erste Paket, auf das es sich
auswirkt (oder in allen Paketen, falls \fB\-A\fR angegeben wurde).
.SH "BEISPIELE"
.IX Header "BEISPIELE"
Eine \fIdebian/manpages\fR\-Datei könnte wie folgt aussehen:
.PP
.Vb 9
\& doc/man/foo.1
\& # Übersetzungen
\& doc/man/foo.da.1
\& doc/man/foo.de.1
\& doc/man/foo.fr.1
\& # NB: Die folgende Zeile wird als polnische Übersetzung von »foo.1« (und
\& # nicht als in Perl geschriebene Handbuchseite namens »foo.pl«) betrachtet
\& doc/man/foo.pl.1
\& # …
.Ve
.SH "ANMERKUNGEN"
.IX Header "ANMERKUNGEN"
Eine ältere Version dieses Programms, \fBdh_installmanpages\fR\|(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.
.SH "SIEHE AUCH"
.IX Header "SIEHE AUCH"
\&\fBdebhelper\fR\|(7)
.PP
Dieses Programm ist Teil von Debhelper.
.SH "ÜBERSETZUNG"
.IX Header "ÜBERSETZUNG"
Diese Übersetzung wurde mit dem Werkzeug
\&\fBpo4a\fR
durch Chris Leick
\&\fIc.leick@vollbio.de\fR
und das deutsche Debian\-Übersetzer\-Team im
Dezember 2011 erstellt.
.PP
Bitte melden Sie alle Fehler in der Übersetzung an
\&\fIdebian\-l10n\-german@lists.debian.org\fR
oder als Fehlerbericht an das Paket
\&\fIdebhelper\fR.
.PP
Sie können mit dem folgenden Befehl das englische
Original anzeigen
man \-L en Abschnitt Handbuchseite
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess