Provided by: man-db_2.9.1-1_amd64 
NOM
manpath - Format du fichier /etc/manpath.config
DESCRIPTION
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 un # seront considérées comme des commentaires et
ignorées.
MANDATORY_MANPATH structure_hiérarchique
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_chemin 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_chemin trouvé dans le $PATH de l'utilisateur, la structure_hiérarchique sera
ajoutée au $MANPATH.
MANDB_MAP structure_hiérarchique [ élément_de_chemin_cat ]
Les lignes de ce type indiquent quelles sont les structures hiérarchiques de pages de manuel qui
doivent être traitées comme « système ». Éventuellement, 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 superutilisateur (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_chemin_cat peut être omis.
Traditional cat placement would be impossible for read only mounted manual page hierarchies and
because of this it is possible to specify any valid directory hierarchy for their storage. To
observe the Linux FSSTND the keyword FSSTND can be used in place of an actual directory.
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.
Étant 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.
SECTION section ...
Les lignes de ce type définissent l'ordre dans lequel les sections de manuel devraient
recherchées. S'il n'y a pas de directives SECTION dans le fichier de configuration, l'ordre par
défaut est :
SECTION 1 n l 8 3 0 2 5 4 9 6 7
Si plusieurs directives SECTION sont données, leurs listes de sections seront concaténées.
Si une extension spécifique n'est pas dans cette liste (par exemple 1mh), elle sera affichée avec
le reste de la section à laquelle elle appartient. Par conséquent, il vous suffit d'expliciter la
liste des extensions si vous voulez forcer un ordre en particulier. Les sections avec extension
devrait habituellement être à côté de leur section principale (par exemple « 1 1mh 8 ... »).
SECTIONS est un nom équivalent pour cette directive.
MINCATWIDTH largeur
Si la largeur du terminal est inférieure à largeur, les pages « cat » ne seront ni créées ni
affichées. La valeur par défaut est 80.
MAXCATWIDTH largeur
Si la largeur du terminal est supérieure à largeur, les pages « cat » ne seront ni créées ni
affichées. La valeur par défaut est 80.
CATWIDTH largeur
Si largeur est non nulle, les pages « cat » seront toujours formatées pour un terminal de la
largeur donnée, quelque soit la largeur du terminal réellement utilisé. Cette valeur devrait être
comprise dans l'intervalle de MINCATWIDTH à MAXCATWIDTH.
NOCACHE
Cet indicateur empêche man(1) de créer automatiquement les pages « cat ».
BOGUES
Si les règles précédentes ne sont pas suivies et observées avec rigueur, les utilitaires d'affichage de
pages de manuel ne fonctionneront pas comme prévu. Ces règles sont excessivement compliquées.
TRADUCTION
Cette traduction est maintenue à l'aide de l'outil po4a <URL:https://po4a.org/> par l'équipe francophone
de traduction de Debian.
Valéry Perrin <valery.perrin.debian@free.fr> le 2 janvier 2006. David Prévot <david@tilapin.org> et
l'équipe francophone de traduction de Debian (2010).
Veuillez signaler toute erreur de traduction en écrivant à <debian-l10n-french@lists.debian.org> ou par
un rapport de bogue sur le paquet man-db.
Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C
<section> <page_de_man> ».