1 files changed, 496 insertions, 0 deletions
diff --git a/man/fr/man.man b/man/fr/man.man
new file mode 100644
index 0000000..ad09529
--- /dev/null
+++ b/man/fr/man.man
@@ -0,0 +1,496 @@
+.\" Man page for man (and the former manpath)
+.\"
+.\" 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
+.\" distribution.  
+.\"
+.\" John W. Eaton
+.\" jwe@che.utexas.edu
+.\" Department of Chemical Engineering
+.\" The University of Texas at Austin
+.\" Austin, Texas  78712
+.\"
+.\" Many changes - aeb
+.\" More changes - flc
+.\"
+.TH MAN 1 "19 septembre 2005" "Manuel Linux" "Commandes utilisateur"
+.LO 1
+.SH NOM
+man \- formate et affiche les pages du manuel en ligne
+.SH SYNOPSIS
+.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. Si
+.I section
+est spécifiée,
+.B man
+ne recherchera que dans cette section du manuel.
+.I nom
+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 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. 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.
+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@.
+.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 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,
+.B man 
+s'arrête après avoir affiché la première page de
+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
+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 ou bien si elle est abîmée.
+.TP
+.B \-\^d
+Ne pas afficher les pages de manuel, mais fournir une grande quantité
+d'informations de débogage.
+.TP
+.B \-\^D
+Afficher à la fois les pages de manuel et les informations de débogage.
+.TP
+.B \-\^f
+Équivalent à
+.BR whatis .
+.TP
+.B \-\^h
+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"
+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
+.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\ :
+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
+Utiliser
+.B @troff@
+pour formater la page de manuel, la sortie se faisant sur
+.B stdout.
+La sortie de 
+.B @troff@
+peut nécessiter un passage par certains filtres avant de pouvoir
+être affichée ou imprimée.
+.TP
+.B \-\^w \fRou\fP \-\-path
+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\ ».
+.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\ :
+.ft CW
+.B man -aW man | xargs ls -l
+.ft
+
+.SH "PAGES FORMATÉES"
+Afin de gagner du temps, 
+.B man 
+tente de sauvegarder les pages formatées
+au lieu de les interpréter chaque fois qu'elles sont demandées.
+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
+.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
+à man et a le mode 0755 (seul man peut l'écrire), et que les fichiers
+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
+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
+que tout utilisateur puisse y laisser le résultat des formatages lors
+des consultations du manuel.
+.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,
+.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
+.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
+.B MANSECT
+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
+sera utilisée. Si aucune des deux variables n'est positionnée,
+.B @pager@
+sera utilisé.
+.TP
+.B LANG
+Si
+.B LANG
+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
+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
+.B "NLSPATH, LC_MESSAGES, LANG"
+Les variables d'environnement
+.B NLSPATH
+et
+.B LC_MESSAGES
+(ou
+.B LANG
+lorsque la dernière n'existe pas)
+jouent un rôle dans la localisation du catalogue de messages.
+(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
+.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. Voir
+.BR "CHEMIN DE RECHERCHE POUR LES PAGES DE MANUEL" .
+.TP
+.B SYSTEM
+.B SYSTEM
+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 BOGUES
+L'option
+.B \-t
+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
+.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.
+