.\" 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 "2021-03-06" "13.3.3~bpo10+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 den richtigen Stellen in Paketbauverzeichnissen vornimmt. .PP In Kompatibilitätsstufe 10 und älter war dieses Programm in erster Linie zur Korrektur 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 wie \fBdh_install\fR\|(1) auch das Standardsuchverzeichnis plus \&\-\-sourcedir und hat dabei den Vorteil, dass es das Bauprofil nodoc beachtet (im Gegensatz zu \fBdh_install\fR\|(1)). .PP Sogar wenn Sie die Verwendung von \fBdh_install\fR\|(1) für das Installieren der Handbuchseiten vorziehen, kann sich \fBdh_installman\fR immer noch nützlich für die Umwandlung der Handbuchseitenkodierung in \s-1UTF\-8\s0 und die Umwandlung von \&\fI.so\fR\-Links (wie unten beschreiben) erweisen. Dieser Teil geschieht jedoch ohne ausdrückliche Konfiguration automatisch. .PP Sie teilen \fBdh_installman\fR mit, welche Handbuchseiten in Ihr Paket kommen und es stellt anhand des Abschnittsfelds in ihrer \fB.TH\fR\- oder \fB.Dt\fR\-Zeile fest, wohin sie zu installieren sind. Falls Sie eine ordentlich formatierte \&\fB.TH\fR\- oder \fB.Dt\fR\-Zeile haben (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), wird Ihre Handbuchseite in das richtige Verzeichnis mit dem richtigen Namen installiert. Ist Ihre \&\fB.TH\fR\- oder \fB.Dt\fR\-Zeile nicht korrekt oder fehlt sie, 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, liegt es daran, dass die Handbuchseite in ihrer \fB.TH\fR\- oder \fB.Dt\fR\-Zeile im falschen Abschnitt eingetragen ist. Bearbeiten Sie die Handbuchseite, korrigieren Sie den Abschnitt und \fBdh_installman\fR wird mitziehen. 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, liegt es daran, dass Ihr Programm einen Namen wie \fIfoo.pl\fR hat und \fBdh_installman\fR ihn so interpretiert als sei sie ins Polnische übersetzt. Benutzen Sie \&\fB\-\-language=C\fR, um das 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 ja, ändert es sie in symbolische Links. .PP Außerdem wird mit Hilfe von man die Zeichenkodierung jeder Handbuchseite erraten und sie in \s-1UTF\-8\s0 umwandeln. Falls die Mutmaßung 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 Ab Debhelper\-Kompatibilitätsstufe 11 wird \fBdh_install\fR in \fIdebian/tmp\fR nach Dateien suchen, wenn es sie nicht im aktuellen Verzeichnis findet (oder wo auch immer Sie ihm mit \fB\-\-sourcedir\fR aufgetragen haben zu suchen). .SH "DATEIEN" .IX Header "DATEIEN" .IP "debian/\fIPaket\fR.manpages" 4 .IX Item "debian/Paket.manpages" listet zu installierende Handbuchseiten auf. .Sp unterstützt Ersetzungsvariablen in Kompatibilitätsstufe 13 oder neuer, wie in \fBdebhelper\fR\|(7) beschrieben. .SH "OPTIONEN" .IX Header "OPTIONEN" .IP "\fB\-A\fR, \fB\-\-all\fR" 4 .IX Item "-A, --all" installiert alle durch Befehlszeilenparameter angegebenen Dateien in \s-1ALLEN\s0 Paketen, 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 wegen seiner der Intuition widersprechenden und uneinheitlichen Schnittstelle veraltet. 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