[c0f3f3]: man / fr / man.man Maximize Restore History

Download this file

man.man    497 lines (486 with data), 14.3 kB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
.\" 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
.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.