Diff of /man/fr/man.man [3bd4dd] .. [c1295e] Maximize Restore

  Switch to side-by-side view

--- a/man/fr/man.man
+++ b/man/fr/man.man
@@ -2,6 +2,7 @@
 .\"
 .\" Copyright (c) 1990, 1991, John W. Eaton.
 .\" Traduction française René Cougnenc - Mai 1995 
+.\" Mise ŕ jour importante Alain Portal le 2 juin 2005
 .\"
 .\" You may distribute under the terms of the GNU General Public
 .\" License as specified in the README file that comes with the man 1.0
@@ -14,116 +15,166 @@
 .\" Austin, Texas  78712
 .\"
 .\" Many changes - aeb
+.\" More changes - flc
 .\"
-.TH MAN 1 "12 Mars 1995" "Manuel Linux" "Commandes utilisateur"
+.TH MAN 1 "19 septembre 2005" "Manuel Linux" "Commandes utilisateur"
 .LO 1
 .SH NOM
 man \- formate et affiche les pages du manuel en ligne
-.br
-manpath \- détermine le chemin de recherche des pages pour l'utilisateur
 .SH SYNOPSIS
-man [\-acdfhktwW] [\-m systčme] [\-p chaîne] [\-C fichier_config] [\-M chemin]
-[\-P visualiseur] [\-S liste_sections] [section] nom ...
+.B man 
+.RB [ \-acdfFhkKtwW ]
+.RB [ --path ]
+.RB [ \-m
+.IR systčme ]
+.RB [ \-p
+.IR chaîne ]
+.RB [ \-C
+.IR fichier_config ]
+.RB [ \-M
+.IR chemin ]
+.RB [ \-P
+.IR visualiseur ]
+.RB [ \-B
+.IR navigateur ]
+.RB [ \-H
+.IR visualiseur_html ]
+.RB [ \-S
+.IR liste_sections ]
+.RI [ section ]
+.I "nom ..."
+
 .SH DESCRIPTION
 .B man
-formate  et  affiche les  pages  du  manuel  en ligne.  Cette  version
-reconnaît les variables d'environnement
-.B MANPATH
-et
-.BR (MAN)PAGER ,
-de sorte que
-vous pouvez avoir  vos propres jeux de manuels  personnels et employer
-le programme de votre choix pour les visualiser. Si
+formate et affiche les pages du manuel en ligne. Si
 .I section
 est spécifiée,
 .B man
-ne  recherchera  que  dans  cette section  particuličre.  Vous  pouvez
-également  indiquer   l'ordre  de  recherche  des   sections  désirées
-ainsi  que les  préprocesseurs ŕ  utiliser pour  traiter les  fichiers
-sources, par  des options de  la ligne  de commandes ou  des variables
-d'environnement. Si
+ne recherchera que dans cette section du manuel.
 .I nom
-contient le caractčre /, il sera d'abord considéré en tant que nom
-de fichier, vous pouvez donc faire :
+est le nom de la page qui est généralement le nom d'une commande,
+d'une fonction ou d'un fichier. Toutefois, si
+.I nom
+contient une barre oblique
+.RB " Ť\ "/ \ ť,
+il sera d'abord considéré en tant que nom de fichier, vous pouvez donc faire\ :
 .B "man ./toto.5"
 ou męme
 .B "man /truc/machin/bidule.1.gz\fR.\fP"
+.PP
+Voir plus loin pour une description sur la façon dont
+.B man
+cherche les fichiers pages de manuel.
+ 
 .SH OPTIONS
 .TP
 .B \-\^C " fichier_config"
-Spécifie le fichier man.conf ŕ utiliser; par défaut il s'agit
-de @man_config_file@. (voir man.conf(5).)  
-.TP
-.B \-\^M " path"
+Spécifie le fichier de configuration ŕ utiliser\ ; par défaut il s'agit de
+.BR @man_config_file@ .
+(Voir
+.BR man.conf (5).)
+.TP
+.B \-\^M " chemin"
 Indique la liste des répertoires dans lesquels la recherche des pages 
-sera effectuée. Si rien n'est spécifié, c'est la variable d'environnement
-.B MANPATH
-qui sera utilisée. Si cette variable n'existe pas, la liste par défaut
-sera déterminée en consultant le fichier @man_config_file@. Si MANPATH
-contient une chaîne vide, celle-ci sera remplacée par la liste par défaut.
+sera effectuée. Veuillez séparer les répertoires par le symbole deux points
+.RB " Ť\ ": \ ť.
+Une liste vide est équivalent ŕ ne pas spécifier l'option
+.BR \-M .
+Voir
+.BR "CHEMIN DE RECHERCHE POUR LES PAGES DE MANUEL" .
 .TP
 .B \-\^P " visualiseur"
 Indique le programme de visualisation des pages ŕ employer.
-Par défaut, 
+Cette option a priorité sur la variable d'environnement
+.BR MANPAGER ,
+qui, ŕ son tour, a priorité sur la variable d'environnement
+.BR PAGER .
+Par défaut,
 .B man 
 utilisera
 .B @pager@.
-Cette option a priorité sur la variable d'environnement
-.B PAGER.
+.TP
+.B \-\^B
+Spécifie quel navigateur utiliser pour les fichiers HTML.
+Cette option supplante la variable d'environnement
+.B BROWSER
+Par défaut,
+.B man
+utilise
+.BR @browser@ .
+.TP
+.B \-\^H
+Spécifie une commande qui produit un fichier texte ŕ partir du fichier HTML.
+Cette option supplante la variable d'environnement
+.B HTMLPAGER
+Par défaut,
+.B man
+utilise
+.BR @htmlpager@ .
 .TP
 .B \-\^S " liste_sections"
-Il s'agit d'une liste de sections, séparées par des deux points,
+Il s'agit d'une liste de sections, séparées par le symbole deux points
+.RB " Ť\ ": \ ť,
 dans lesquelles les pages seront recherchées. Elle a priorité sur
 la variable d'environnement
 .B MANSECT.
 .TP
 .B \-\^a
-Par défaut, 
+Par défaut,
 .B man 
 s'arręte aprčs avoir affiché la premičre page de
-manuel trouvée. Cette option permet de lui faire afficher toutes
-les pages correspondant ŕ la requęte Ť   
-.B nom
-ť de l'utilisateur, s'il y en a plusieurs.
+manuel trouvée. Cette option permet de l'obliger ŕ afficher toutes
+les pages correspondant ŕ la requęte
+.RB " Ť\ "nom \ ť
+de l'utilisateur, s'il y en a plusieurs, et pas seulement la premičre trouvée.
 .TP
 .B \-\^c
-Reformate la page de manuel, męme si une version préformatée ŕ jour
+Reformater la page de manuel, męme si une version préformatée ŕ jour
 existe. Cela peut ętre utile si cette derničre a été prévue pour un
-écran de taille différente, par exemple.
+écran de taille différente ou bien si elle est abîmée.
 .TP
 .B \-\^d
-N'affiche pas les pages de manuel, mais fournit une grande quantité
-d'informations de déboguage.
+Ne pas afficher les pages de manuel, mais fournir une grande quantité
+d'informations de débogage.
 .TP
 .B \-\^D
-Affiche ŕ la fois les pages de manuel et les informations de déboguage.
+Afficher ŕ la fois les pages de manuel et les informations de débogage.
 .TP
 .B \-\^f
 Équivalent ŕ
-.B whatis.
+.BR whatis .
 .TP
 .B \-\^h
-Affiche un court message d'aide.
+Afficher un court message d'aide et quitter.
 .TP
 .B \-\^k
 Équivalent ŕ
 .B apropos.
 .TP
+.B \-\^K
+Chercher la chaîne spécifiée dans *toutes* les pages de manuel. Attention\ :
+cela peut ętre trčs long\ ! Et il peut ętre utile de spécifier une section.
+(Pour donner une vague idée, sur ma machine, il faut environ une minute
+pour 500 pages de manuel.)
+.TP
 .B \-\^m " systčme"
-Demande l'utilisation d'un autre jeu de pages de manuel, en fonction
+Demander l'utilisation d'un autre jeu de pages de manuel, en fonction
 du nom de systčme indiqué.
 .TP
 .B \-\^p " chaîne"
-Spécifie la séquence de préprocesseurs ŕ exécuter avant nroff ou troff.
+Spécifie la séquence de préprocesseurs ŕ exécuter avant
+.B nroff
+ou
+.BR troff .
 Selon votre installation de Linux, vous ne disposerez pas forcément
 de tous les programmes possibles. Voici les  plus courants et les lettres
-qui les désignent:
+qui les désignent\ :
 eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r).
 Cette option a priorité sur la variable d'environnement
 .B MANROFFSEQ.
 .TP
 .B \-\^t
-Emploie
+Utiliser
 .B @troff@
 pour formater la page de manuel, la sortie se faisant sur
 .B stdout.
@@ -133,20 +184,20 @@
 ętre affichée ou imprimée.
 .TP
 .B \-\^w \fRou\fP \-\-path
-N'affiche pas les pages de manuel, mais les emplacements des fichiers
+Ne pas afficher les pages de manuel, mais les emplacements des fichiers
 qui auraient été formatés ou affichés. Si aucun argument n'est précisé,
 indique sur la sortie standard la liste des répertoires dans lesquels
 .B man
 recherche les pages. Si
 .B manpath
-est un lien sur le programme man, alors Ť manpath ť est équivalent
-ŕ la commande Ť man --path ť.
+est un lien sur le programme man, alors Ť\ manpath\ ť est équivalent
+ŕ la commande Ť\ man --path\ ť.
 .TP
 .B \-\^W
 Comme \-\^w, mais affiche les noms de fichiers, un par ligne, sans aucune
-autre information. Trčs utile dans des commandes shell du genre:
+autre information. Trčs utile dans des commandes shell du genre\ :
 .ft CW
-man -aW man | xargs ls -l
+.B man -aW man | xargs ls -l
 .ft
 
 .SH "PAGES FORMATÉES"
@@ -157,40 +208,187 @@
 Traditionnellement, les versions formatées des pages de REP/manX sont
 enregistrées dans REP/catX, mais d'autres correspondances entre les
 répertoires man et les répertoires cat peuvent ętre indiquées dans
-le fichier  @man_config_file@. Si le répertoire Ť cat ť correspondant
-n'existe pas, les pages formatées ne seront pas enregistrées.
-.LP
+le fichier
+.BR @man_config_file@ .
+Aucune page formatée n'est enregistrée si le répertoire Ť\ cat\ ť correspondant
+n'existe pas.
+Aucune page formatée n'est enregistrée si elle est formatée avec une longueur
+de ligne différente de 80.
+Aucune page formatée n'est enregistrée si le fichier
+.B @man_config_file@
+contient la ligne NOCACHE.
+.PP
 Il est possible de rendre
 .B man
-suid utilisateur man. Dans ce cas, si un répertoire cat appartient
+suid utilisateur man. Dans ce cas, si un répertoire Ť\ cat\ ť appartient
 ŕ man et a le mode 0755 (seul man peut l'écrire), et que les fichiers
-cat appartiennent eux aussi ŕ man et ont le mode 0644 ou 0444 (seul
+formatés appartiennent eux aussi ŕ man et ont le mode 0644 ou 0444 (seul
 man peut les écrire, voire personne), aucun utilisateur normal ne pourra
-changer de pages formatées ou mettre d'autre fichiers dans le répertoire
+modifier les pages formatées ou mettre d'autre fichiers dans le répertoire
 correspondant. Si
 .B man
-n'est pas suid, les répertoires cat devront avoir le mode 0777 afin
+n'est pas suid, les répertoires Ť cat ť devront avoir le mode 0777 afin
 que tout utilisateur puisse y laisser le résultat des formatages lors
 des consultations du manuel.
-.LP
-L'option -c force le reformatage d'une page, męme si un fichier cat
+.PP
+L'option
+.B \-c
+force le reformatage d'une page, męme si un fichier cat
 plus récent que le fichier source existe.
 
+.SH "CHEMIN DE RECHERCHE POUR LES PAGES DE MANUEL"
+.B man
+utilise une méthode sophistiquée pour chercher les pages de manuels,
+basée sur l'invocation d'options et de variables d'environnement,
+le fichier de configuration
+.BR @man_config_file@ ,
+des heuristiques et conventions prédéfinies.
+.PP
+En premier lieu, lorsque l'argument
+.I nom
+de
+.B man
+contient une barre oblique
+.RB " Ť\ "/ \ ť,
+.B man
+suppose qu'il s'agit d'un fichier et aucune recherche complexe n'est lancée.
+.PP
+Mais dans la plupart des cas oů
+.I nom
+ne contient pas de barre oblique,
+.B man
+recherche dans plusieurs répertoires un fichier qui pourrait ętre une page
+de manuel pour le sujet nommé.
+.PP
+Si vous spécifiez l'option
+.B \-M
+.IR liste_chemins ,
+.I liste_chemins
+est une liste de répertoires, séparés par le symbole deux points 
+.RB " Ť\ ": \ ť,
+dans lesquels
+.B man
+effectuera sa recherche.
+.PP
+Si vous ne spécifiez pas
+.B -M
+mais que vous positionniez la variable d'environnement
+.BR MANPATH ,
+la valeur de cette variable est la liste des répertoires dans lesquels
+.B man
+effectuera sa recherche.
+.PP
+Si vous ne spécifiez pas une liste de chemins explicite avec
+.B -M
+ou 
+.BR MANPATH ,
+.B man
+développe sa propre liste de chemins basée sur le contenu du fichier de
+configuration 
+.BR @man_config_file@ .
+Les déclarations
+.B MANPATH
+dans le fichier de configuration identifient des répertoires particuliers
+ŕ inclure dans le chemin de recherche.
+.PP
+Qui plus est, les déclarations
+.B MANPATH_MAP
+complčtent le chemin de recherche en fonction du chemin de recherche de vos
+commandes (autrement dit, de votre variable d'environnement
+.BR PATH ).
+La déclaration
+.B MANPATH_MAP
+indique, pour chacun des répertoires pouvant se trouver dans le chemin de
+recherche des commandes, un répertoire qui devrait ętre ajouté au chemin de
+recherche des pages de manuel.
+.B man
+scrute la variable
+.B PATH
+et ajoute au chemin de recherche des pages de manuel les répertoires
+correspondants. Ainsi, avec une utilisation correcte de
+.BR MANPATH_MAP ,
+lorsque vous tapez la commande
+.BR "man xyz" ,
+vous obtenez la page de manuel du programme que vous lanceriez si vous
+tapiez la commande
+.BR xyz .
+.PP
+De plus, pour chacun des répertoires situés dans le chemin de recherche des
+commandes (nous l'appellerons Ť\ répertoire commandes\ ť) pour lequel vous
+.IR n "'avez " pas
+d'instruction
+.BR MANPATH_MAP ,
+.B man
+cherchera automatiquement un répertoire de pages de manuel ŕ proximité,
+ŕ savoir un sous-répertoire du Ť\ répertoire commandes\ ť lui-męme ou dans
+le répertoire parent du Ť\ répertoire commandes\ ť.
+.PP
+Vous pouvez désactiver la recherche automatique de proximité en incluant
+l'instruction
+.B NOAUTOPATH
+dans le fichier de configuration
+.BR @man_config_file@ .
+.PP
+Dans chaque répertoire du chemin de recherche décrit plus haut,
+.B man
+cherche un fichier nommé
+.IB sujet . section\fR,
+avec un suffixe optionnel sur le numéro de section et un possible suffixe
+de compression. S'il ne peut trouver un tel fichier, il regarde alors dans
+tous les sous-répertoires nommés
+.BI man N
+ou
+.BI cat N
+oů
+.I N
+est le numéro de la section du manuel. Si le fichier se trouve dans
+le sous-répertoire
+.B cat
+.IR N ,
+.B man
+suppose qu'il s'agit d'une page de manuel formatée (page cat). Autrement,
+.B man
+suppose qu'elle n'est pas formatée. Dans tous les cas, si le nom de
+fichier comporte une extension indiquant une compression connue (comme
+.BR .gz ),
+.B man
+suppose que le fichier est gzippé.
+.PP
+Si vous vouloir savoir oů (ou si)
+.B man
+peut trouver une page de manuel sur un sujet particulier, utilisez l'option
+.BR "--path " ( -w ).
 
 .SH ENVIRONNEMENT
 .TP
 .B MANPATH
 Si la variable
 .B MANPATH
-est positionnée, sa valeur sera utilisée comme chemin de recherche
-des pages de manuel.
+est positionnée,
+.B man
+utilisera sa valeur comme chemin de recherche des pages de manuel.
+Cette variable est prioritaire sur le fichier de configuration et le chemin
+de recherche automatique, mais cčde cette priorité si l'option
+.B -M
+est utilisée. Voir
+.BR "CHEMIN DE RECHERCHE POUR LES PAGES DE MANUEL" .
+.TP
+.B MANPL
+Si la variable
+.B MANPL
+est positionnée, sa valeur servira ŕ définir la longueur de l'affichage de la
+page. Autrement, la page entičre est affichée sur une seule et longue page.
 .TP
 .B MANROFFSEQ
 Si
 .B MANROFFSEQ
 est positionnée, sa valeur servira ŕ déterminer le jeu de préprocesseurs
-ŕ exécuter avant de lancer nroff ou troff. Par défaut, les pages sont
-passées dans le processeur de tableaux avant nroff.
+ŕ exécuter avant de lancer
+.B nroff
+ou
+.BR troff .
+Par défaut, les pages sont passées dans le processeur de tableaux avant
+.BR nroff .
 .TP
 .B MANSECT
 Si
@@ -198,12 +396,21 @@
 est positionnée, sa valeur déterminera les sections du manuel dans
 lesquelles les pages seront recherchées.
 .TP
+.B MANWIDTH
+Si
+.B MANWIDTH
+est positionnée, sa valeur servira ŕ définir la largeur de l'affichage de la
+page. Autrement, la page sera affichée sur toute la largeur de l'écran.
+.TP
+.B MANPAGER
+Si
+.B MANPAGER
+est positionnée, sa valeur sera considérée comme le nom du programme
+ŕ utiliser pour visualiser la page de manuel. Dans le cas contraire,
 .B PAGER
-Si
-.B PAGER
-est positionnée, sa valeur sera considérée comme le nom du programme
-ŕ utiliser pour afficher la page de manuel. Par défaut, il s'agira de
-.B @pager@.
+sera utilisée. Si aucune des deux variables n'est positionnée,
+.B @pager@
+sera utilisé.
 .TP
 .B LANG
 Si
@@ -211,7 +418,7 @@
 est positionnée, sa valeur définira le nom du sous-répertoire oů
 .B man
 commencera la recherche des pages de manuel. Ainsi, la commande
-Ť LANG=fr man 1 toto ť aura pour effet de faire rechercher la page
+Ť\ LANG=fr man 1 toto\ ť aura pour effet de faire rechercher la page
 toto dans .../fr/man1/toto.1, et si ce fichier n'existe pas, 
 dans .../man1/toto.1, oů ... est un répertoire du chemin de recherche.
 .TP
@@ -227,25 +434,63 @@
 (Mais les messages anglais sont inclus dans le programme ŕ la compilation,
 aucun catalogue n'est donc nécessaire pour un affichage dans la langue de
 Shakespeare.)
-Notez que les programmes comme col(1) qui sont appelés par 
-.B man,
+Notez que les programmes comme
+.BR col (1)
+qui sont appelés par 
+.BR man ,
 utilisent également LC_CTYPE.
 .TP
 .B PATH
 .B PATH
-est utilisée pour la construction du chemin de recherche par défaut.
+est utilisée pour la construction du chemin de recherche par défaut. Voir
+.BR "CHEMIN DE RECHERCHE POUR LES PAGES DE MANUEL" .
 .TP
 .B SYSTEM
 .B SYSTEM
-employée pour obtenir les systčmes alternatifs par défaut (en vue de
+est employée pour obtenir le nom du systčme alternatif par défaut (en vue de
 l'utilisation de l'option 
 .B \-m
 ). 
-.SH "VOIR AUSSI"
-apropos(1), whatis(1), less(1), groff(1).
-.SH BUGS
+.SH BOGUES
 L'option
 .B \-t
-ne fonctionne que si un programme Ť troff-like ť est installé.
+ne fonctionne que si un programme Ť\ troff-like\ ť est installé.
+.br
+Si vous voyez clignoter \e255 ou <AD> au lieu de traits d'union,
+mettez Ť\ LESSCHARSET=latin1\ ť dans votre environnement.
+.SH ASTUCES
+Si vous ajoutez la ligne
+
+  (global-set-key [(f1)] (lambda () (interactive) (manual-entry (current-word))))
+
+ŕ votre fichier
+.IR .emacs ,
+vous obtiendrez la page de manuel de l'appel de la bibliothčque situé ŕ la
+position courante du curseur lorsque vous presserez la touche F1.
+.LP
+Pour obtenir une version texte seul d'une page de manuel, sans retour arričre
+ni caractčre de soulignement, essayez
+
+  # man foo | col -b > foo.mantxt
+
+.SH AUTEUR
+John W. Eaton est l'auteur historique de
+.BR man .
+Federico Lucifredi <flucifredi@acm.org> en assure aujourd'hui la maintenance.
+.SH "VOIR AUSSI"
+.BR apropos (1),
+.BR whatis (1),
+.BR less (1),
+.BR groff (1),
+.BR man.conf (5).
 .SH TRADUCTION
-René Cougnenc, 1995.
+.PP
+Ce document est une traduction réalisée par René Cougnenc en mai 1995 et mise
+ŕ jour par Alain Portal <aportal@univ-montp2.fr> le 7 novembre 2005.
+.PP
+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\ : Ť\ \fBLANG=en\ man\ 1\ man\fR\ ť.
+N'hésitez pas ŕ signaler ŕ l'auteur ou au traducteur, selon le cas, toute
+erreur dans cette page de manuel.
+