.\" 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 "2017-01-25" "10.2.5" "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. .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. .Sp Im Kompatibilitätsmodus 11 werden diese in \fI/usr/share/doc/mainpackage\fR installiert. Vorher wäre dies \fI/usr/share/doc/package\fR gewesen. .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\-\-link\-doc=\fR\fIPaket\fR" 4 .IX Item "--link-doc=Paket" veranlasst, dass das Dokumentationsverzeichnis aller Pakete, auf die es sich auswirkt, ein symbolischer Link 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 \&\fB\s-1WARNUNG\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\-symbolischer\-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. .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