.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" 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
..
.if !\nF .nr F 0
.if \nF>0 \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
.\}
.\" ========================================================================
.\"
.IX Title "DH_INSTALLDOCS 1"
.TH DH_INSTALLDOCS 1 "2019-04-08" "12.1.1~bpo9+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_installdocs \- installiert Dokumentation in Paketbauverzeichnisse
.SH "ÜBERSICHT"
.IX Header "ÜBERSICHT"
\&\fBdh_installdocs\fR [\fIDebhelper-Optionen\fR] [\fB\-A\fR] [\fB\-X\fR\fIElement\fR]
[\fIDatei\fR …]
.SH "BESCHREIBUNG"
.IX Header "BESCHREIBUNG"
\&\fBdh_installdocs\fR ist ein Debhelper-Programm, das für die Installation von
Dokumentation in \fIusr/share/doc/Paket\fR im Paketbauverzeichniszuständig ist.
.PP
In Kompatibilitätsstufe 10 und älter war \fIdh_install\fR\|(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 \fBdh_installdocs\fR
immer noch nützlich, um paketierungsbezogene Dokumentation (z.B. die Datei
\&\fIdebian/copyright\fR) zu installieren.
.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).
.PP
In compat 11 and later, \fBdh_installdocs\fR offers many of the features that
\&\fIdh_install\fR\|(1) also has. Furthermore, \fBdh_installdocs\fR also supports the
\&\fBnodoc\fR build profile to exclude documentation (regardless of compat
level).
.SH "DATEIEN"
.IX Header "DATEIEN"
.IP "debian/\fIPaket\fR.docs" 4
.IX Item "debian/Paket.docs"
listet Dokumentationsdateien auf, die in \fIPaket\fR installiert werden sollen.
.IP "\fIdebian/copyright\fR" 4
.IX Item "debian/copyright"
Die Copyright-Datei ist in allen Paketen installiert, außer wenn eine
speziellere Copyright-Datei verfügbar ist.
.IP "debian/\fIPaket\fR.copyright" 4
.IX Item "debian/Paket.copyright"
.PD 0
.IP "debian/\fIPaket\fR.README.Debian" 4
.IX Item "debian/Paket.README.Debian"
.IP "debian/\fIPaket\fR.TODO" 4
.IX Item "debian/Paket.TODO"
.PD
Jede dieser Dateien wird automatisch installiert, falls sie für ein \fIPaket\fR
vorhanden ist.
.IP "\fIdebian/README.Debian\fR" 4
.IX Item "debian/README.Debian"
.PD 0
.IP "\fIdebian/TODO\fR" 4
.IX Item "debian/TODO"
.PD
Diese Dateien werden in das erste Binärpaket installiert, das in
»debian/control« aufgeführt ist.
.Sp
Beachten Sie, dass \fI\s-1README\s0.debian\fR\-Dateien auch als \fI\s-1README\s0.Debian\fR und
\&\fI\s-1TODO\s0\fR\-Dateien in nicht nativen Paketen auch als \fI\s-1TODO\s0.Debian\fR installiert
werden.
.IP "debian/\fIPaket\fR.doc\-base" 4
.IX Item "debian/Paket.doc-base"
sind als doc-base-Steuerdateien installiert. Beachten Sie, dass die Doc-ID
vom Eintrag \fBDocument:\fR in der bestreffenden Doc-base-Steuerdatei bestimmt
wird. Im Fall, dass mehrere Doc-base-Dateien in einem einzelnen Quellpaket
die gleiche Doc-ID gemeinsam benutzen, werden sie nach
usr/share/doc\-base/package statt nach usr/share/doc\-base/doc\-id installiert.
.IP "debian/\fIPaket\fR.doc\-base.*" 4
.IX Item "debian/Paket.doc-base.*"
Falls es nötig ist, dass Ihr Paket mehr als ein Dokument registriert,
benötigen Sie mehrere Doc-base-Dateien und können sie so wie diese
benennen. Im Fall, dass mehrere Doc-base-Dateien in diesem Stil in einem
einzelnen Quellpaket die gleiche Doc-ID gemeinsam benutzen, werden sie nach
usr/share/doc\-base/package\-* statt nach usr/share/doc\-base/doc\-id
installiert.
.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\-X\fR\fIElement\fR, \fB\-\-exclude=\fR\fIElement\fR" 4
.IX Item "-XElement, --exclude=Element"
schließt Dateien von der Installation aus, die \fIElement\fR in ihrem
Dateinamen enthalten. Beachten Sie, dass dies doc-base-Dateien einschließt.
.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 "\fB\-\-doc\-main\-package=\fR\fIHauptpaket\fR" 4
.IX Item "--doc-main-package=Hauptpaket"
setzt das Hauptpaket für ein Dokumentationspaket. Dies wird zur Installation
der Dokumentation des Dokumentationspakets in \fI/usr/share/doc/\fIHauptpaket\fI\fR benutzt, wie es das
Debian-Richlinienhandbuch 3.9.7 in §12.3 empfiehlt.
.Sp
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.
.Sp
Diese Option kann nicht verwendet werden, wenn \fBdh_installdocs\fR angewiesen
wurde, auf mehrere Pakete einzuwirken. Falls Sie diese Option benötigen,
werden Sie sie üblicherweise mit \fB\-p\fR kombinieren müssen, um
sicherzustellen, dass nur auf exakt ein Paket eingewirkt wird.
.Sp
Bitte denken Sie daran, dass manche Dokumentation (die Copyright-Datei,
\&\s-1README\s0.Debian, etc.) nicht von dieser Option beeinflusst wird.
.IP "\fB\-\-link\-doc=\fR\fIPaket\fR" 4
.IX Item "--link-doc=Paket"
veranlasst, dass das Dokumentationsverzeichnis aller Pakete, auf die es sich
auswirkt, ein symbolischer Links auf das Dokumentationsverzeichnis von
\&\fIPaket\fR ist. Dies hat keine Auswirkungen, wenn auf das \fIPaket\fR selbst
eingewirkt wird oder falls das Dokumentationsverzeichnis, das erstellt
werden soll, bereits bei der Ausführung von \fBdh_installdocs\fR existiert. Um
der Richtlinie zu entsprechen, muss \fIPaket\fR ein Binärpaket sein, das vom
selben Quellpaket stammt.
.Sp
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 \fB\-A\fR wird keine Auswirkungen auf
Pakete mit verknüpften Dokumentationsverzeichnissen haben und die Dateien
\&\fIcopyright\fR, \fIchangelog\fR, \fI\s-1README\s0.Debian\fR und \fI\s-1TODO\s0\fR werden nicht
installiert.
.Sp
(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 \fBdh_installdocs\fR aufgerufen wird.)
.Sp
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. \fB\-\-doc\-main\-package\fR), wird es keinen symbolischen
Link für die Dokumentation des anderen Pakets verwenden.
.Sp
\&\fB\s-1WARNUNG 1\s0\fR: 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.
.Sp
Dies kann durch Bereitstellen einer »debian/\fIPaket\fR.maintscript«\-Datei und
mittels \fIdh_installdeb\fR\|(1) erledigt werden. Dadurch werden die passenden
Betreuerskriptschnipsel zur Verfügung gestellt.
.Sp
\&\fB\s-1CAVEAT 2\s0\fR: The use of \fB\-\-link\-doc\fR should only be done when the packages
have same \*(L"architecture\*(R" type. A link from an architecture independent
package to an architecture dependent package (or vice versa) will not work.
Since compat 10, debhelper will actively reject unsupported combinations.
.IP "<\fIDatei\fR …" 4
.IX Item "
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