349 lines
11 KiB
HTML
349 lines
11 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of DH_INSTALLDOCS</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>DH_INSTALLDOCS</H1>
|
||
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>NAME</H2>
|
||
|
||
dh_installdocs - installiert Dokumentation in Paketbauverzeichnisse
|
||
<A NAME="lbAC"> </A>
|
||
<H2>ÜBERSICHT</H2>
|
||
|
||
|
||
|
||
<B>dh_installdocs</B> [<I>Debhelper-Optionen</I>] [<B>-A</B>] [<B>-X</B><I>Element</I>]
|
||
[<I>Datei</I> …]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>BESCHREIBUNG</H2>
|
||
|
||
|
||
|
||
<B>dh_installdocs</B> ist ein Debhelper-Programm, das für die Installation von
|
||
Dokumentation in <I>usr/share/doc/Paket</I> im Paketbauverzeichniszuständig ist.
|
||
<P>
|
||
|
||
In Kompatibilitätsstufe 10 und älter war <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(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 <B>dh_installdocs</B>
|
||
immer noch nützlich, um paketierungsbezogene Dokumentation (z.B. die Datei
|
||
<I>debian/copyright</I>) zu installieren.
|
||
<P>
|
||
|
||
Ab Debhelper-Kompatibilitätsstufe 11 wird <B>dh_install</B> in <I>debian/tmp</I>
|
||
nach Dateien suchen, wenn es sie nicht im aktuellen Verzeichnis findet (oder
|
||
wo auch immer Sie ihm mit <B>--sourcedir</B> aufgetragen haben, zu suchen).
|
||
<P>
|
||
|
||
In Kompatibilitätsstufe 11 und neuer bietet <B>dh_installdocs</B> viele der
|
||
Funktionalitäten, die auch <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) hat. Desweiteren unterstützt
|
||
<B>dh_installdocs</B> außerdem das Bauprofil <B>nodoc</B>, um Dokumentation
|
||
(unabhängig von der Kompatibilitätsstufe) auszuschließen.
|
||
<A NAME="lbAE"> </A>
|
||
<H2>DATEIEN</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>Paket</I>.docs<DD>
|
||
|
||
|
||
listet Dokumentationsdateien auf, die in <I>Paket</I> installiert werden sollen.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
unterstützt Ersetzungsvariablen in Kompatibilitätsstufe 13 oder neuer, wie
|
||
in <B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7) beschrieben.
|
||
<DT id="2"><I>debian/copyright</I><DD>
|
||
|
||
|
||
Die Copyright-Datei ist in allen Paketen installiert, außer wenn eine
|
||
speziellere Copyright-Datei verfügbar ist.
|
||
<DT id="3">debian/<I>Paket</I>.copyright<DD>
|
||
|
||
|
||
|
||
<DT id="4">debian/<I>Paket</I>.README.Debian<DD>
|
||
|
||
|
||
<DT id="5">debian/<I>Paket</I>.TODO<DD>
|
||
|
||
|
||
|
||
Jede dieser Dateien wird automatisch installiert, falls sie für ein <I>Paket</I>
|
||
vorhanden ist.
|
||
<DT id="6"><I>debian/README.Debian</I><DD>
|
||
|
||
|
||
|
||
<DT id="7"><I>debian/TODO</I><DD>
|
||
|
||
|
||
|
||
Diese Dateien werden in das erste Binärpaket installiert, das in
|
||
»debian/control« aufgeführt ist.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Beachten Sie, dass <I></I><FONT SIZE="-1"><I>README</I></FONT><I>.debian</I>-Dateien auch als <I></I><FONT SIZE="-1"><I>README</I></FONT><I>.Debian</I> und
|
||
<I></I><FONT SIZE="-1"><I>TODO</I></FONT><I></I>-Dateien in nicht nativen Paketen auch als <I></I><FONT SIZE="-1"><I>TODO</I></FONT><I>.Debian</I> installiert
|
||
werden.
|
||
<DT id="8">debian/<I>Paket</I>.doc-base<DD>
|
||
|
||
|
||
sind als doc-base-Steuerdateien installiert. Beachten Sie, dass die Doc-ID
|
||
vom Eintrag <B>Document:</B> 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.
|
||
<DT id="9">debian/<I>Paket</I>.doc-base.*<DD>
|
||
|
||
|
||
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.
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPTIONEN</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="10"><B>-A</B>, <B>--all</B><DD>
|
||
|
||
|
||
installiert alle Dateien, die durch Befehlszeilenparameter in <FONT SIZE="-1">ALLEN</FONT> Paketen
|
||
angegeben werden, auf die es sich auswirkt.
|
||
<DT id="11"><B>-X</B><I>Element</I>, <B>--exclude=</B><I>Element</I><DD>
|
||
|
||
|
||
schließt Dateien von der Installation aus, die <I>Element</I> in ihrem
|
||
Dateinamen enthalten. Beachten Sie, dass dies doc-base-Dateien einschließt.
|
||
<DT id="12"><B>--sourcedir=</B><I>Verz</I><DD>
|
||
|
||
|
||
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).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Beachten Sie, dass dies nicht das Gleiche wie die Option
|
||
<B>--sourcedirectory</B> ist, die von <B>dh_auto_</B><I>*</I>-Befehlen benutzt wird. Sie
|
||
benötigen diese Option selten, da <B>dh_installman</B> in
|
||
Debhelper-Kompatibilitätsstufe 11 und darüber automatisch in <I>debian/tmp</I>
|
||
nach Dateien sucht.
|
||
<DT id="13"><B>--doc-main-package=</B><I>Hauptpaket</I><DD>
|
||
|
||
|
||
setzt das Hauptpaket für ein Dokumentationspaket. Dies wird zur Installation
|
||
der Dokumentation des Dokumentationspakets in <I>/usr/share/doc/Hauptpaket</I> benutzt, wie es das
|
||
Debian-Richlinienhandbuch 3.9.7 in §12.3 empfiehlt.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
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.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Diese Option kann nicht verwendet werden, wenn <B>dh_installdocs</B> angewiesen
|
||
wurde, auf mehrere Pakete einzuwirken. Falls Sie diese Option benötigen,
|
||
werden Sie sie üblicherweise mit <B>-p</B> kombinieren müssen, um
|
||
sicherzustellen, dass nur auf exakt ein Paket eingewirkt wird.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Bitte denken Sie daran, dass manche Dokumentation (die Copyright-Datei,
|
||
<FONT SIZE="-1">README</FONT>.Debian, etc.) nicht von dieser Option beeinflusst wird.
|
||
<DT id="14"><B>--link-doc=</B><I>Paket</I><DD>
|
||
|
||
|
||
veranlasst, dass das Dokumentationsverzeichnis aller Pakete, auf die es sich
|
||
auswirkt, ein symbolischer Links auf das Dokumentationsverzeichnis von
|
||
<I>Paket</I> ist. Dies hat keine Auswirkungen, wenn auf das <I>Paket</I> selbst
|
||
eingewirkt wird oder falls das Dokumentationsverzeichnis, das erstellt
|
||
werden soll, bereits bei der Ausführung von <B>dh_installdocs</B> existiert. Um
|
||
der Richtlinie zu entsprechen, muss <I>Paket</I> ein Binärpaket sein, das vom
|
||
selben Quellpaket stammt.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
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 <B>-A</B> wird keine Auswirkungen auf
|
||
Pakete mit verknüpften Dokumentationsverzeichnissen haben und die Dateien
|
||
<I>copyright</I>, <I>changelog</I>, <I></I><FONT SIZE="-1"><I>README</I></FONT><I>.Debian</I> und <I></I><FONT SIZE="-1"><I>TODO</I></FONT><I></I> werden nicht
|
||
installiert.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
(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 <B>dh_installdocs</B> aufgerufen wird.)
|
||
|
||
|
||
<P>
|
||
|
||
|
||
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. <B>--doc-main-package</B>), wird es keinen symbolischen
|
||
Link für die Dokumentation des anderen Pakets verwenden.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
<B></B><FONT SIZE="-1"><B>WARNUNG 1</B></FONT><B></B>: 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.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Dies kann durch Bereitstellen einer »debian/<I>Paket</I>.maintscript«-Datei und
|
||
mittels <B><A HREF="/cgi-bin/man/man2html?1+dh_installdeb">dh_installdeb</A></B>(1) erledigt werden. Dadurch werden die passenden
|
||
Betreuerskriptschnipsel zur Verfügung gestellt.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
<B></B><FONT SIZE="-1"><B>WARNUNG 2</B></FONT><B></B>: <B>--link-doc</B> sollte nur benutzt werden, wenn die Pakete
|
||
denselben »architecture«-Typ haben. Ein Link von einem
|
||
architekturunabhängigen zu einem architekturabhängigen Paket (oder
|
||
umgekehrt) wird nicht funktionieren. Seit Kompatibilitätsstufe 10 wird
|
||
Debhelper nicht unterstützte Kombinationen aktiv zurückweisen.
|
||
<DT id="15"><<I>Datei</I> …<DD>
|
||
|
||
|
||
installiert diese Dateien als Dokumentation in das erste Paket, auf die es
|
||
sich auswirkt (oder in allen Paketen, falls <B>-A</B> angegeben wurde).
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>BEISPIELE</H2>
|
||
|
||
|
||
|
||
Dies ist ein Beispiel einer <I>debian/Paket.docs</I>-Datei:
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
README
|
||
TODO
|
||
debian/notes-for-maintainers.txt
|
||
docs/manual.txt
|
||
docs/manual.pdf
|
||
docs/manual-html/
|
||
|
||
</PRE>
|
||
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>ANMERKUNGEN</H2>
|
||
|
||
|
||
|
||
Beachten Sie, dass <B>dh_installdocs</B> klaglos ganze Verzeichnishierarchien
|
||
kopiert, falls Sie es verlangen (ähnlich <B>cp -a</B>). Falls verlangt wurde,
|
||
ein Verzeichnis zu installieren, wird es den kompletten Inhalt des
|
||
Verzeichnisses installieren.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>SIEHE AUCH</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
Dieses Programm ist Teil von Debhelper.
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>ÜBERSETZUNG</H2>
|
||
|
||
|
||
|
||
Diese Übersetzung wurde mit dem Werkzeug
|
||
<B>po4a</B>
|
||
<<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>>
|
||
durch Chris Leick
|
||
<I><A HREF="mailto:c.leick@vollbio.de">c.leick@vollbio.de</A></I>
|
||
und das deutsche Debian-Übersetzer-Team im
|
||
Dezember 2011 erstellt.
|
||
<P>
|
||
|
||
Bitte melden Sie alle Fehler in der Übersetzung an
|
||
<I><A HREF="mailto:debian-l10n-german@lists.debian.org">debian-l10n-german@lists.debian.org</A></I>
|
||
oder als Fehlerbericht an das Paket
|
||
<I>debhelper</I>.
|
||
<P>
|
||
|
||
Sie können mit dem folgenden Befehl das englische
|
||
Original anzeigen
|
||
man -L en Abschnitt Handbuchseite
|
||
<A NAME="lbAK"> </A>
|
||
<H2>AUTOR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="16"><A HREF="#lbAB">NAME</A><DD>
|
||
<DT id="17"><A HREF="#lbAC">ÜBERSICHT</A><DD>
|
||
<DT id="18"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
|
||
<DT id="19"><A HREF="#lbAE">DATEIEN</A><DD>
|
||
<DT id="20"><A HREF="#lbAF">OPTIONEN</A><DD>
|
||
<DT id="21"><A HREF="#lbAG">BEISPIELE</A><DD>
|
||
<DT id="22"><A HREF="#lbAH">ANMERKUNGEN</A><DD>
|
||
<DT id="23"><A HREF="#lbAI">SIEHE AUCH</A><DD>
|
||
<DT id="24"><A HREF="#lbAJ">ÜBERSETZUNG</A><DD>
|
||
<DT id="25"><A HREF="#lbAK">AUTOR</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:04:55 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|