NOM
manpath - format du fichier /etc/manpath.config
Le fichier de configuration de manpath est exploité par divers
utilitaires dédiés aux pages de manuel. Il sert à déterminer, lors de
l'exécution, les chemins d'accès personnels aux pages de manuel. Cela
permet d'indiquer les structures hiérarchiques de pages de manuel
(manpaths) devant être considérées comme des structures hiérarchiques
système ainsi qu'à leur assigner les répertoires à employer pour le
stockage des fichiers cat.
Si la variable d'environnement $MANPATH est définie, l'information
contenue dans /etc/manpath.config ne la remplacera pas.
FORMAT
Les types de champs suivants sont actuellement reconnus :
# commentaire
Les lignes vides ou celles commençant par # seront considérées
comme des commentaires et ignorées.
MANDATORY_MANPATH structure_hirarchique
Les lignes de ce type précisent les structures hiérarchiques de
pages de manuel que doivent contenir tous les $MANPATH produits
automatiquement. En général, cela inclut /usr/man.
MANPATH_MAP élément_de_path structure_hiérarchique
Les lignes de ce type établissent la correspondance entre un des
éléments du chemin de recherche $PATH et la structure
hiérarchique qui contient les pages de manuel correspondantes
$MANPATH. Pour chaque élément_de_path trouvé dans le $PATH de
l'utilisateur, la structure_hiérarchique sera ajoutée au
$MANPATH.
MANDB_MAP structure_hiérarchique[ élément_de_catpath ]
Les lignes de ce type indiquent quelles sont les structures
hiérarchiques de pages de manuel qui doivent être traitées comme
système. Eventuellement, elles précisent également le lieu de
stockage des fichiers cat correspondant. Ce type de ligne est
particulièrement important dans le cas où man s'exécute avec les
droits du super-utilisateur (setuid). En effet, quand le fichier
de configuration système /etc/manpath.config existe au lieu du
fichier de configuration par utilisateur .manpath, il indique
les structures hiérarchiques de pages de manuel auxquelles man
accède en tant qu'utilisateur setuid et celles auxquelles il
accède en tant qu'utilisateur normal.
Les structures hiérarchiques de pages de manuel système sont
celles habituellement stockées dans /usr ainsi que dans /usr/man
, /usr/local/man et /usr/X11R6/man.
Si les pages cat d'une structure_hiérarchique ne doivent pas
être stockées ou doivent être stockées à l'emplacement habituel,
élément_de_catpath peut être omis.
L'emplacement habituel des pages .cat serait inutilisable pour
des structures hiérarchiques de pages de manuel montées en
lecture seule. C'est pourquoi il est possible d'indiquer
n'importe quel répertoire valide pour leur stockage. Afin de
respecter le Linux FSSTND le mot-clé FSSTND peut être employé à
la place d'un répertoire.
Malheureusement, il est nécessaire d'indiquer tous les chemins
vers les pages de manuel système, y compris les chemins d'accès
aux pages des autres systèmes d'exploitation tel que
/usr/man/sun, ainsi que tous les chemins de localisation NLS
locale comme /usr/man/de_DE.88591.
Etant donné que l'information est analysée ligne par ligne, dans
l'ordre d'écriture, il est nécessaire que chaque chemin d'accès
aux pages de manuel forme une sous-structure hiérarchique
indiquée préalablement à la structure hiérarchique qui la
contient, sinon un résultat incorrect surviendra. Par exemple
/usr/man/de_DE.88591 doit être indiqué avant /usr/man.
DEFINE clé valeur
Les lignes de ce type définissent diverses variables de
configuration. Consultez le fichier de configuration par défaut
pour connaître les variables employées par les utilitaires de
pages de manuel. Ces variables incluent les chemins d'accès par
défaut à divers programmes (tels que grep et tbl), et fixent les
valeurs par défaut des arguments de ces programmes.
BOGUES
A moins que les règles ci-dessus ne soient suivies et observées avec
précision, les utilitaires de gestion des pages de manuel ne
fonctionneront pas comme attendu. Ces règles sont excessivement
compliquées.
TRADUCTION
Valéry Perrin <valery.perrin.debian@free.fr> le 2 janvier 2006.
L'quipe de traduction a fait le maximum pour réaliser une adaptation
française de qualité.
La version anglaise la plus à jour de ce document est toujours
consultable via la commande man -L en nom_de_la_page .
N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, une
erreur dans cette page de manuel.