man-pages/de/man1/dh_installman.1.html
2021-03-31 01:06:50 +01:00

244 lines
8.1 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of DH_INSTALLMAN</TITLE>
</HEAD><BODY>
<H1>DH_INSTALLMAN</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">&nbsp;</A>
<H2>NAME</H2>
dh_installman - installiert Handbuchseiten in Paketbauverzeichnisse
<A NAME="lbAC">&nbsp;</A>
<H2>ÜBERSICHT</H2>
<B>dh_installman</B> [<I>Debhelper-Optionen</I>] [<I>Handbuchseite</I> …]
<A NAME="lbAD">&nbsp;</A>
<H2>BESCHREIBUNG</H2>
<B>dh_installman</B> ist ein Debhelper-Programm, das die Installation von
Handbuchseiten an korrekten Stellen in Paketbauverzeichnissen handhabt.
<P>
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 auch das Standardsuchverzeichnis plus --sourcedir wie
<B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) und hat den Vorteil, dass es das Bauprofil nodoc beachtet (im
Gegensatz zu <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1)).
<P>
Sogar wenn Sie die Verwendung von <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) für das Installieren der
Handbuchseiten vorziehen, kann <B>dh_installman</B> immer noch nützlich (wie
unten beschreiben) sein für die Umwandlung der Handbuchseitenkodierung in
<FONT SIZE="-1">UTF-8</FONT> und die Umwandlung von <I>.so</I>-Links . Dieser Teil geschieht jedoch
ohne ausdrückliche Konfiguration automatisch.
<P>
Sie teilen <B>dh_installman</B> mit, welche Handbuchseiten in Ihr Paket kommen
und es ergründet, wohin sie installiert werden, basierend auf dem
Abschnittsfeld in ihrer <B>.TH</B>- oder <B>.Dt</B>-Zeile. Falls Sie eine ordentlich
formatierte <B>.TH</B>- oder <B>.Dt</B>-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 <B>3perl</B>, die
in <I>man3</I> platziert werden und Angabe einer Erweiterung von
<I>.3perl</I>). Falls Ihre <B>.TH</B>- oder <B>.Dt</B>-Zeile nicht korrekt ist oder
fehlt, wird das Programm möglicherweise aufgrund der Dateiendung falsch
raten.
<P>
Es unterstützt außerdem übersetzte Handbuchseiten, indem es Endungen wie
<I>.ll.8</I> und <I>.ll_LL.8</I> auswertet oder indem der Schalter <B>--language</B>
benutzt wird.
<P>
Falls <B>dh_installman</B> eine Handbuchseite in den falschen Abschnitt oder mit
der falschen Endung zu installieren scheint, ist dies, weil die
Handbuchseite den falschen Abschnitt in ihrer <B>.TH</B>- oder <B>.Dt</B>-Zeile
aufführt. Bearbeiten Sie die Handbuchseite, korrigieren Sie den Abschnitt
und <B>dh_installman</B> wird passend folgen. Einzelheiten über die <B>.TH</B>-Zeile
finden Sie in <B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7) und über die <B>.Dt</B>-Zeile in <B><A HREF="/cgi-bin/man/man2html?7+mdoc">mdoc</A></B>(7). Falls
<B>dh_installman</B> eine Handbuchseite in ein Verzeichnis wie
<I>/usr/share/man/pl/man1/</I> zu installieren scheint, ist dies, weil Ihr
Programm einen Namen wie <I>foo.pl</I> hat und <B>dh_installman</B> annimmt, dass
dies bedeutet, sie sei ins Polnische übersetzt. Benutzen Sie
<B>--language=C</B>, um dies zu vermeiden.
<P>
Nach dem Installationsschritt für Handbuchseiten wird <B>dh_installman</B>
prüfen, ob einige der Handbuchseiten in den temporären Verzeichnissen in
irgendwelchen Paketen, auf die es sich auswirkt, <I>.so</I>-Links
enthalten. Falls dies so ist, ändert es sie in symbolische Links.
<P>
<B>dh_installman</B> wird außerdem die Zeichenkodierung jeder Handbuchseite
raten und sie in <FONT SIZE="-1">UTF-8</FONT> 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 <B><A HREF="/cgi-bin/man/man2html?1+manconv">manconv</A></B>(1).
<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).
<A NAME="lbAE">&nbsp;</A>
<H2>DATEIEN</H2>
<DL COMPACT>
<DT id="1">debian/<I>Paket</I>.manpages<DD>
listet zu installierende Handbuchseiten auf.
<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.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>OPTIONEN</H2>
<DL COMPACT>
<DT id="2"><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="3"><B>--language=</B><I>ll</I><DD>
Benutzen Sie dies, um anzugeben, dass die Handbuchseiten, auf die es sich
auswirkt, in der angegebenen Sprache geschrieben sind.
<DT id="4"><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="5"><I>Handbuchseite</I>&gt;<DD>
installiert diese Handbuchseiten in das erste Paket, auf das es sich
auswirkt (oder in allen Paketen, falls <B>-A</B> angegeben wurde).
</DL>
<A NAME="lbAG">&nbsp;</A>
<H2>BEISPIELE</H2>
Eine <I>debian/manpages</I>-Datei könnte wie folgt aussehen:
<P>
<PRE>
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
# …
</PRE>
<A NAME="lbAH">&nbsp;</A>
<H2>ANMERKUNGEN</H2>
Eine ältere Version dieses Programms, <B><A HREF="/cgi-bin/man/man2html?1+dh_installmanpages">dh_installmanpages</A></B>(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.
<A NAME="lbAI">&nbsp;</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">&nbsp;</A>
<H2>ÜBERSETZUNG</H2>
Diese Übersetzung wurde mit dem Werkzeug
<B>po4a</B>
&lt;<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>&gt;
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">&nbsp;</A>
<H2>AUTOR</H2>
Joey Hess &lt;<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="6"><A HREF="#lbAB">NAME</A><DD>
<DT id="7"><A HREF="#lbAC">ÜBERSICHT</A><DD>
<DT id="8"><A HREF="#lbAD">BESCHREIBUNG</A><DD>
<DT id="9"><A HREF="#lbAE">DATEIEN</A><DD>
<DT id="10"><A HREF="#lbAF">OPTIONEN</A><DD>
<DT id="11"><A HREF="#lbAG">BEISPIELE</A><DD>
<DT id="12"><A HREF="#lbAH">ANMERKUNGEN</A><DD>
<DT id="13"><A HREF="#lbAI">SIEHE AUCH</A><DD>
<DT id="14"><A HREF="#lbAJ">ÜBERSETZUNG</A><DD>
<DT id="15"><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>