Provided by: man-db_2.6.1-2_i386 bug

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_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 lment_de_chemin  structure_hirarchique
              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 lment_de_chemin trouvé dans le $PATH  de
              l'utilisateur,   la   structure_hirarchique   sera  ajoutée  au
              $MANPATH.

       MANDB_MAP structure_hirarchique [ lment_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_hirarchique ne doivent pas
              être stockées ou doivent être stockées à l'emplacement habituel,
              lment_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> ».