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.

              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. Pour respecter le Linux FSSTND le mot-clé FSSTND peut être
              employé à la place d'un répertoire réel.

              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:http://po4a.alioth.debian.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> ».