Comment installer un fichier de page de manuel au niveau du système?
Par exemple, si j'ai un fichier de page de manuel examplecommand.1
, comment puis-je l'installer pour que je puisse simplement taper man examplecommand
pour l'afficher?
D'abord, trouvez à quelle section appartient votre page de manuel. Si c'est une commande, elle appartient probablement à la section 1
. Vous pouvez lire la page de manuel relative à la commande man
pour voir une description des différentes sections et leurs numéros correspondants.
Copiez votre page de manuel sur /usr/local/share/man/man1/
(modifiez 1
si nécessaire). Vous pouvez également l'installer dans /usr/share/man/man1/
, mais il est recommandé d'utiliser le répertoire local
pour les fichiers installés sans utiliser le gestionnaire de packages APT:
sudo cp examplecommand.1 /usr/local/share/man/man1/
Exécutez la commande mandb
. Cela mettra à jour la base de données interne de man
:
sudo mandb
C'est ça! Vous devriez pouvoir afficher la page de manuel en exécutant:
man 1 examplecommand
man
mandb
/usr/bin/dh_installman
si vous pouvez lire Perl, installé avec le package debhelper
. Si vous devez uniquement installer la page de manuel localement :
Si MANPATH
n'est pas défini ou inclut un composant vide (c'est-à-dire commence par :
, se termine par :
ou contient ::
), <path>/share/man
sera automatiquement recherché % fait partie de <path>/bin
, pour toutes les valeurs de PATH
.
Cela fournit un moyen très simple d’ajouter des pages de manuel pour les logiciels installés localement. Il y a quelques détails dans <path>
et man manpath
, mais je ne vois aucune mention du mappage générique de /etc/manpath.config
à <path>/bin
.
Lire d'autres questions sur les étiquettes command-line manpage