dh_installman - Installer les pages de manuel dans le répertoire de
construction du paquet
dh_installman [
options_de_debhelper]
[
page-de-manuel ...]
dh_installman 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.
Jusqu'au niveau de compatibilité 10, ce programme était
utilisé principalement lorsque le système de construction amont
ne les installait pas correctement lors de la phase d'installation (ou n'avait
de phase d'installation). À partir du niveau de
compatibilité 11, il prend aussi en charge le répertoire
de recherche par défaut et en plus
--sourcedir comme
dh_install(1) et a l'avantage de respecter le profil de construction
nodoc (contrairement à
dh_install(1)).
Même si vous préférez
dh_install(1) pour installer
les pages de manuel,
dh_installman peut être utile pour
convertir les pages en UTF-8 et les liens
.so (comme décrit plus
bas). De plus, cela est effectué automatiquement sans configuration
explicite.
À partir de la liste des pages de manuel à installer,
dh_installman examine la section indiquée à la ligne
.TH ou
.Dt de la page et en déduit la destination. Si la
ligne
.TH ou
.Dt 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
3perl, qui sera placée
en
man3 et portera l'extension
.3perl. Si la ligne
.TH ou
.Dt est erronée ou absente, le programme peut faire une mauvaise
déduction, basée sur l'extension du fichier.
dh_installman gère également les traductions de pages de
manuel soit en cherchant des extensions telles que
.ll.8 et
ll_LL.8, soit en utilisant l'option
--language. (NdT :
« ll » représente le code langue sur deux
caractères et « LL » la variante locale sur
deux caractères également. Par exemple : fr_BE pour le
français de Belgique.)
Si
dh_installman 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
.TH ou
.Dt
erronée. Il suffit d'éditer la page de manuel et de corriger la
section pour que
dh_installman fonctionne correctement. Voir
man(7) pour les précisions sur la section
.TH et
mdoc(7) pour la section
.Dt. Si
dh_installman installe
une page de manuel dans un répertoire tel que
/usr/share/man/pl/man1/ c'est parce que le programme possède un
nom comme
toto.pl et que
dh_installman pense que la page de
manuel est traduite en polonais (pl). Il suffit d'utiliser
--language=C
pour lever cette ambiguïté.
Après l'étape d'installation des pages de manuel,
dh_installman vérifie si des pages de manuel, contenues dans les
répertoires temporaires des paquets traités, contiennent des
liens
.so. Dans ce cas, il les transforme en liens symboliques.
Également,
dh_installman 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 UTF-8. Si, pour une raison quelconque, cette
reconnaissance n'est pas correcte, vous pouvez forcer l'encodage en utilisant
une déclaration d'encodage. Consulter
manconv(1) pour obtenir
plus de détails.
Depuis la version 11 de debhelper,
dh_install cherchera dans
l'arborescence
debian/tmp pour trouver les fichiers s'il ne les trouve
pas dans le répertoire courant (ou dans celui indiqué par
l'utilisation de
--sourcedir).
- debian/paquet.manpages
- Liste les pages de manuel à installer.
Les variables de substitution sont prises en charge dans les niveaux de
compatibilité 13 et ultérieurs comme documenté
dans debhelper(7).
-
-A, --all
- Installe l'ensemble des fichiers indiqués sur la
ligne de commande dans tous les paquets construits.
-
--language=ll
- Permet d'indiquer que les pages de manuel doivent
être traitées comme étant écrites dans le
langage indiqué par « ll ».
-
--sourcedir=répertoire
- 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).
Nota : cette option ne fait pas la même chose que
--sourcedirectory utilisée par dh_auto_*. Il
est rare d'avoir besoin d'utiliser cette option puisque
dh_installman cherche automatiquement les fichiers dans
debian/tmp depuis le niveau de compatibilité 11 de
debhelper.
-
page-de-manuel ...
- Installe les pages de manuel indiquées dans le
premier paquet traité (ou dans tous les paquets traités si
-A est indiqué).
Un fichier exemple de
debian/manpages ressemblerait à
ceci :
doc/man/toto.1
# Traductions
doc/man/toto.da.1
doc/man/toto.de.1
doc/man/toto.fr.1
# NB: La ligne suivante est considérée comme une traduction polonaise
# de "toto.1" (pas une page de manuel écrite en Perl appelée toto.pl)
doc/man/toto.pl.1
# ...
Une ancienne version de ce programme,
dh_installmanpages(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.
debhelper(7)
Ce programme fait partie de debhelper.
Joey Hess <
[email protected]>
Cette traduction est maintenue à l'aide de l'outil po4a
<URL:
http://po4a.alioth.debian.org/> par l'équipe francophone de
traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<
[email protected]> ou par un rapport de bogue sur le
paquet debhelper.
Vous pouvez toujours avoir accès à la version anglaise de ce
document en utilisant la commande « man -L C <section>
<page_de_man> ».