176 lines
8.1 KiB
HTML
176 lines
8.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of MANPATH</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>MANPATH</H1>
|
|
Section: /etc/manpath.config (5)<BR>Updated: 2020-02-25<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NOM</H2>
|
|
|
|
manpath - Format du fichier /etc/manpath.config
|
|
<A NAME="lbAC"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
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 ».
|
|
<P>
|
|
Si la variable d'environnement $<B>MANPATH</B> est définie, l'information
|
|
contenue dans /etc/manpath.config ne la remplacera pas.
|
|
<A NAME="lbAD"> </A>
|
|
<H2>FORMAT</H2>
|
|
|
|
Les types de champs suivants sont actuellement reconnus :
|
|
<DL COMPACT>
|
|
<DT id="1"><B>#</B><I> commentaire</I><DD>
|
|
Les lignes vides ou celles commençant par un <B>#</B> seront considérées comme
|
|
des commentaires et ignorées.
|
|
<DT id="2"><B>MANDATORY_MANPATH</B><I> structure_hiérarchique</I><DD>
|
|
Les lignes de ce type précisent les structures hiérarchiques de pages de
|
|
manuel que doivent contenir tous les $<B>MANPATH</B> produits
|
|
automatiquement. En général, cela inclut <I>/usr/man</I>.
|
|
<DT id="3"><B>MANPATH_MAP</B><I> élément_de_chemin structure_hiérarchique</I><DD>
|
|
Les lignes de ce type établissent la correspondance entre un des éléments du
|
|
chemin de recherche $<B>PATH</B> et la structure hiérarchique qui contient les
|
|
pages de manuel correspondantes $<B>MANPATH</B>. Pour chaque
|
|
<I>élément_de_chemin</I> trouvé dans le $<B>PATH</B> de l'utilisateur, la
|
|
<I>structure_hiérarchique</I> sera ajoutée au $<B>MANPATH</B>.
|
|
<DT id="4"><B>MANDB_MAP </B><I>structure_hiérarchique </I>[ <I>élément_de_chemin_cat</I> ]<DD>
|
|
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ù <B>man</B> 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 <B>man</B> accède en tant qu'utilisateur setuid et celles
|
|
auxquelles il accède en tant qu'utilisateur normal.
|
|
<P>
|
|
Les structures hiérarchiques de pages de manuel « système » sont celles
|
|
habituellement stockées dans <I>/usr</I> ainsi que dans <I>/usr/man</I>,
|
|
<I>/usr/local/man</I> et <I>/usr/X11R6/man</I>.
|
|
<P>
|
|
Si les pages « cat » d'une <I>structure_hiérarchique</I> ne doivent pas être
|
|
stockées ou doivent être stockées à l'emplacement habituel,
|
|
<I>élément_de_chemin_cat</I> peut être omis.
|
|
<P>
|
|
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 <B>Linux FSSTND</B> the
|
|
keyword <B>FSSTND</B> can be used in place of an actual directory.
|
|
<P>
|
|
Malheureusement, il est nécessaire d'indiquer <B>tous</B> 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 <I>/usr/man/sun</I>, ainsi que tous les
|
|
chemins de localisation <B>NLS locale</B> comme <I>/usr/man/de_DE.88591</I>.
|
|
<P>
|
|
É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 <I>/usr/man/de_DE.88591</I> doit être indiqué avant <I>/usr/man</I>.
|
|
<DT id="5"><B>DEFINE</B><I> clé valeur</I><DD>
|
|
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 <B>grep</B> et <B>tbl</B>), et fixent les valeurs par défaut
|
|
des arguments de ces programmes.
|
|
<DT id="6"><B>SECTION</B> <I>section</I> ...<DD>
|
|
<DL COMPACT><DT id="7"><DD>
|
|
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 <B>SECTION</B> dans le
|
|
fichier de configuration, l'ordre par défaut est :
|
|
<P>
|
|
|
|
<DL COMPACT><DT id="8"><DD>
|
|
<PRE>
|
|
SECTION 1 n l 8 3 0 2 5 4 9 6 7</PRE>
|
|
|
|
</DL>
|
|
|
|
<P>
|
|
|
|
Si plusieurs directives <B>SECTION</B> sont données, leurs listes de sections
|
|
seront concaténées.
|
|
<P>
|
|
|
|
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 ... »).
|
|
<P>
|
|
|
|
<B>SECTIONS</B> est un nom équivalent pour cette directive.
|
|
</DL>
|
|
|
|
<DT id="9"><B>MINCATWIDTH</B><I> largeur</I><DD>
|
|
Si la largeur du terminal est inférieure à <I>largeur</I>, les pages « cat » ne
|
|
seront ni créées ni affichées. La valeur par défaut est 80.
|
|
<DT id="10"><B>MAXCATWIDTH</B><I> largeur</I><DD>
|
|
Si la largeur du terminal est supérieure à <I>largeur</I>, les pages « cat » ne
|
|
seront ni créées ni affichées. La valeur par défaut est 80.
|
|
<DT id="11"><B>CATWIDTH</B><I> largeur</I><DD>
|
|
Si <I>largeur</I> 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
|
|
<B>MINCATWIDTH</B> à <B>MAXCATWIDTH</B>.
|
|
<DT id="12"><B>NOCACHE</B>
|
|
|
|
|
|
<DD>
|
|
Cet indicateur empêche <B><A HREF="/cgi-bin/man/man2html?1+man">man</A></B>(1) de créer automatiquement les pages
|
|
« cat ».
|
|
</DL>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>BOGUES</H2>
|
|
|
|
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.
|
|
<A NAME="lbAF"> </A>
|
|
<H2>TRADUCTION</H2>
|
|
|
|
Cette traduction est maintenue à l'aide de l'outil
|
|
po4a <URL:<A HREF="https://po4a.org/">https://po4a.org/</A>> par l'équipe
|
|
francophone de traduction de Debian.
|
|
<P>
|
|
|
|
Valéry Perrin <<A HREF="mailto:valery.perrin.debian@free.fr">valery.perrin.debian@free.fr</A>> le 2 janvier 2006.
|
|
David Prévot <<A HREF="mailto:david@tilapin.org">david@tilapin.org</A>> et l'équipe francophone de traduction de Debian (2010).
|
|
<P>
|
|
|
|
Veuillez signaler toute erreur de traduction en écrivant à
|
|
<<A HREF="mailto:debian-l10n-french@lists.debian.org">debian-l10n-french@lists.debian.org</A>> ou par un rapport de bogue sur
|
|
le paquet man-db.
|
|
<P>
|
|
|
|
Vous pouvez toujours avoir accès à la version anglaise de ce document en
|
|
utilisant la commande
|
|
« <B>man -L C</B> <I><section></I> <I><page_de_man></I> ».
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="13"><A HREF="#lbAB">NOM</A><DD>
|
|
<DT id="14"><A HREF="#lbAC">DESCRIPTION</A><DD>
|
|
<DT id="15"><A HREF="#lbAD">FORMAT</A><DD>
|
|
<DT id="16"><A HREF="#lbAE">BOGUES</A><DD>
|
|
<DT id="17"><A HREF="#lbAF">TRADUCTION</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:02 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|