243 lines
8.2 KiB
HTML
243 lines
8.2 KiB
HTML
|
||
<!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"> </A>
|
||
<H2>NOM</H2>
|
||
|
||
|
||
|
||
dh_installman - Installer les pages de manuel dans le répertoire de
|
||
construction du paquet
|
||
<A NAME="lbAC"> </A>
|
||
<H2>SYNOPSIS</H2>
|
||
|
||
|
||
|
||
<B>dh_installman</B> [<I>options_de_debhelper</I>] [<I>page-de-manuel</I> ...]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIPTION</H2>
|
||
|
||
|
||
|
||
<B>dh_installman</B> est un programme de la suite debhelper chargé de
|
||
l'installation automatique des pages de manuel au bon endroit dans le
|
||
répertoire de construction du paquet.
|
||
<P>
|
||
|
||
In compat 10 and earlier, this program was primarily for when upstream's
|
||
build system does not properly install them as a part of its install step
|
||
(or it does not have an install step). In compat 11 and later, it also
|
||
supports the default searchdir plus --sourcedir like <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) and has
|
||
the advantage that it respects the nodoc build profile (unlike
|
||
<B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1)).
|
||
<P>
|
||
|
||
Même si vous préférez <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) pour installer les pages de manuel,
|
||
<B>dh_installman</B> peut être utile pour convertir les pages en <FONT SIZE="-1">UTF-8</FONT> et les
|
||
liens <I>.so</I> (comme décrit plus bas). De plus, cela est effectué
|
||
automatiquement sans configuration explicite.
|
||
<P>
|
||
|
||
À partir de la liste des pages de manuel à installer, <B>dh_installman</B>
|
||
examine la section indiquée à la ligne <B>.TH</B> ou <B>.Dt</B> de la page et en
|
||
déduit la destination. Si la ligne <B>.TH</B> ou <B>.Dt</B> est correctement
|
||
renseignée, les pages de manuel seront installées dans la bonne section avec
|
||
le nom adéquat. Ce mécanisme fonctionne également pour les pages comportant
|
||
des sous-sections, telles que <B>3perl</B>, qui sera placée en <I>man3</I> et
|
||
portera l'extension <I>.3perl</I>. Si la ligne <B>.TH</B> ou <B>.Dt</B> est erronée ou
|
||
absente, le programme peut faire une mauvaise déduction, basée sur
|
||
l'extension du fichier.
|
||
<P>
|
||
|
||
<B>dh_installman</B> gère également les traductions de pages de manuel soit en
|
||
cherchant des extensions telles que <I>.ll.8</I> et <I>ll_LL.8</I>, soit en
|
||
utilisant l'option <B>--language</B>. (NdT : « ll » représente le code langue
|
||
sur deux caractères et « <FONT SIZE="-1">LL</FONT> » la variante locale sur deux caractères
|
||
également. Par exemple : fr_BE pour le français de Belgique.)
|
||
<P>
|
||
|
||
Si <B>dh_installman</B> installe une page de manuel dans la mauvaise section ou
|
||
avec une extension erronée, c'est parce que la page de manuel possède une
|
||
section comportant une ligne <B>.TH</B> ou <B>.Dt</B> erronée. Il suffit d'éditer la
|
||
page de manuel et de corriger la section pour que <B>dh_installman</B>
|
||
fonctionne correctement. Voir <B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7) pour les précisions sur la section
|
||
<B>.TH</B> et <B><A HREF="/cgi-bin/man/man2html?7+mdoc">mdoc</A></B>(7) pour la section <B>.Dt</B>. Si <B>dh_installman</B> installe
|
||
une page de manuel dans un répertoire tel que <I>/usr/share/man/pl/man1/</I>
|
||
c'est parce que le programme possède un nom comme <I>toto.pl</I> et que
|
||
<B>dh_installman</B> pense que la page de manuel est traduite en polonais
|
||
(pl). Il suffit d'utiliser <B>--language=C</B> pour lever cette ambiguïté.
|
||
<P>
|
||
|
||
Après l'étape d'installation des pages de manuel, <B>dh_installman</B> vérifie
|
||
si des pages de manuel, contenues dans les répertoires temporaires des
|
||
paquets traités, contiennent des liens <I>.so</I>. Dans ce cas, il les
|
||
transforme en liens symboliques.
|
||
<P>
|
||
|
||
Également, <B>dh_installman</B> va regarder le contenu de la page de manuel pour
|
||
déterminer l'encodage des caractères de chaque page de manuel et de les
|
||
convertir en <FONT SIZE="-1">UTF-8.</FONT> Si, pour une raison quelconque, cette reconnaissance
|
||
n'est pas correcte, vous pouvez forcer l'encodage en utilisant une
|
||
déclaration d'encodage. Consulter <B><A HREF="/cgi-bin/man/man2html?1+manconv">manconv</A></B>(1) pour obtenir plus de
|
||
détails.
|
||
<P>
|
||
|
||
Depuis la version 11 de debhelper, <B>dh_install</B> cherchera dans
|
||
l'arborescence <I>debian/tmp</I> pour trouver les fichiers s'il ne les trouve
|
||
pas dans le répertoire courant (ou dans celui indiqué par l'utilisation de
|
||
<B>--sourcedir</B>).
|
||
<A NAME="lbAE"> </A>
|
||
<H2>FICHIERS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>paquet</I>.manpages<DD>
|
||
|
||
|
||
Liste les pages de manuel à installer.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Supports substitution variables in compat 13 and later as documented in
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7).
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPTIONS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="2"><B>-A</B>, <B>--all</B><DD>
|
||
|
||
|
||
Installe l'ensemble des fichiers indiqués sur la ligne de commande dans
|
||
<B>tous</B> les paquets construits.
|
||
<DT id="3"><B>--language=</B><I>ll</I><DD>
|
||
|
||
|
||
Permet d'indiquer que les pages de manuel doivent être traitées comme étant
|
||
écrites dans le langage indiqué par « ll ».
|
||
<DT id="4"><B>--sourcedir=</B><I>répertoire</I><DD>
|
||
|
||
|
||
Cherche dans le répertoire indiqué les fichiers à installer. Cette option
|
||
nécessite le niveau de compatibilité 11 ou supérieur (et sera
|
||
silencieusement ignorée en version 10 et avant).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Nota : cette option ne fait pas la même chose que <B>--sourcedirectory</B>
|
||
utilisée par <B>dh_auto_</B><I>*</I>. Il est rare d'avoir besoin d'utiliser cette
|
||
option puisque <B>dh_installman</B> cherche automatiquement les fichiers dans
|
||
<I>debian/tmp</I> depuis le niveau de compatibilité 11 de debhelper.
|
||
<DT id="5"><I>page-de-manuel</I> ...<DD>
|
||
|
||
|
||
Installe les pages de manuel indiquées dans le premier paquet traité (ou
|
||
dans tous les paquets traités si <B>-A</B> est indiqué).
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>EXEMPLES</H2>
|
||
|
||
|
||
|
||
Un fichier exemple de <I>debian/manpages</I> ressemblerait à ceci :
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
doc/man/foo.1
|
||
# Traductions
|
||
doc/man/foo.da.1
|
||
doc/man/foo.de.1
|
||
doc/man/foo.fr.1
|
||
# NB: La ligne suivante est considérée comme une traduction polonaise
|
||
# de "foo.1" (pas une page de manuel écrite en Perl appelée "foo.pl")
|
||
doc/man/foo.pl.1
|
||
# ...
|
||
|
||
</PRE>
|
||
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>REMARQUES</H2>
|
||
|
||
|
||
|
||
Une ancienne version de ce programme, <B><A HREF="/cgi-bin/man/man2html?1+dh_installmanpages">dh_installmanpages</A></B>(1), est encore
|
||
employée dans quelques paquets. Pour cette raison, l'ancienne version est
|
||
encore incluse dans debhelper. Il est cependant déconseillé de l'employer en
|
||
raison de son interface non intuitive et contradictoire. Il faut employer ce
|
||
programme à la place.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>VOIR AUSSI</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
Ce programme fait partie de debhelper.
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>AUTEUR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<A NAME="lbAK"> </A>
|
||
<H2>TRADUCTION</H2>
|
||
|
||
|
||
|
||
Cette traduction est maintenue à l'aide de l'outil po4a
|
||
<URL:<A HREF="http://po4a.alioth.debian.org/">http://po4a.alioth.debian.org/</A>> par l'équipe francophone de traduction
|
||
de Debian.
|
||
<P>
|
||
|
||
Veuillez signaler toute erreur de traduction en écrivant à
|
||
<<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>> ou par un rapport de bogue sur le paquet
|
||
debhelper.
|
||
<P>
|
||
|
||
Vous pouvez toujours avoir accès à la version anglaise de ce document en
|
||
utilisant la commande « man -L C <section> <page_de_man> ».
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="6"><A HREF="#lbAB">NOM</A><DD>
|
||
<DT id="7"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
||
<DT id="8"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
||
<DT id="9"><A HREF="#lbAE">FICHIERS</A><DD>
|
||
<DT id="10"><A HREF="#lbAF">OPTIONS</A><DD>
|
||
<DT id="11"><A HREF="#lbAG">EXEMPLES</A><DD>
|
||
<DT id="12"><A HREF="#lbAH">REMARQUES</A><DD>
|
||
<DT id="13"><A HREF="#lbAI">VOIR AUSSI</A><DD>
|
||
<DT id="14"><A HREF="#lbAJ">AUTEUR</A><DD>
|
||
<DT id="15"><A HREF="#lbAK">TRADUCTION</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:05:01 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|