DH_INSTALLMAN(1) Debhelper DH_INSTALLMAN(1)
NOM
dh_installman - Installer les pages de manuel dans le répertoire de
construction du paquet
SYNOPSIS
dh_installman [options_de_debhelper] [page-de-manuel ...]
DESCRIPTION
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).
FICHIERS
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).
OPTIONS
-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é).
EXEMPLES
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
# ...
REMARQUES
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.
VOIR AUSSI
debhelper(7)
Ce programme fait partie de debhelper.
AUTEUR
Joey Hess <joeyh@debian.org>
TRADUCTION
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 à
<debian-l10n-french@lists.debian.org> 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> ».
13.11.4 2023-01-02 DH_INSTALLMAN(1)
Generated by dwww version 1.15 on Sat Jun 29 01:53:15 CEST 2024.