Loading

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.