[078234]: man / it / man.man  Maximize  Restore  History

Download this file

270 lines (265 with data), 8.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
.\" Man page for man (and the former manpath)
.\"
.\" Copyright (c) 1990, 1991, John W. Eaton.
.\" 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
.\"
.\" Traduzione italiana by Michele Dalla Silvestra - dalla@maya.dei.unipd.it
.\" Luglio 1996
.\" Correzioni stilistiche di Daniele Giacomini <daniele@evo.it>
.\" Gennaio 1999
.\" Aggiornamento a 1.5g di Ottavio Rizzo <rizzo@pluto.linux.it>
.\"
.TH man 1 "2 settembre 1995"
.LO 1
.SH NOME
man \- formatta e mostra le pagine di guida in linea
.br
manpath \- determina i percorsi di ricerca dell'utente per le pagine di
guida
.SH SINTASSI
man [\-acdfFhkKtwW] [\-m sistema] [\-p stringa] [\-C file_configurazione]
[\-M percorso] [\-P impaginatore] [\-S lista_sezioni] [sezione] nome ...
.SH DESCRIZIONE
.B man
formatta e mostra le pagine di guida in linea. Questa versione
riconosce le variabili d'ambiente
.B MANPATH
e
.RB ( MAN ) PAGER ,
in modo da avere il proprio insieme di pagine di guida e scegliere
il programma preferito per leggere le pagine formattate. Se
.I sezione
� specificata,
.B man
cerca solamente in quella sezione del manuale.
Si pu� anche specificare l'ordine di ricerca delle sezioni e quale
preprocessore utilizzare tramite un'opzione della riga di comando o variabile
d'ambiente.
Se
.I nome
contiene un carattere /, allora questo viene prima provato come se
fosse il nome di un file, in modo da
poter fare
.B "man ./foo.5"
o anche
.B "man /cd/foo/bar.1.gz\fR.\fP"
.SH OPZIONI
.TP
.B \-\^C " file_configurazione"
Specifica il file man.config da usare; il valore di default �
@man_config_file@ (vedere
.BR man.conf (5)).
.TP
.B \-\^M " percorso"
Specifica la lista di directory in cui cercare le pagine di guida. Se
questa opzione manca, viene usata la variabile d'ambiente
.BR MANPATH .
Se tale variabile d'ambiente non ci fosse, l'elenco di default �
trovato consultando @man_config_file@. Una sottostringa vuota di
MANPATH denota la lista di default.
.TP
.B \-\^P " impaginatore"
Specifica il programma di impaginazione da usare. Per default man usa
.BR @pager@ .
Questa opzione sovrascrive la variabile d'ambiente
.BR MANPAGER ,
che sovrascrive a sua volta la variabile
.BR PAGER .
.TP
.B \-\^S " lista_sezioni"
La lista � un elenco separato dal carattere due punti di sezioni di
guide da cercare. Questa opzione sovrascrive la variabile d'ambiente
.BR MANSECT .
.TP
.B \-\^a
Di natura, man esce dopo aver mostrato la prima pagina di guida
trovata. Usando questa opzione si forza man a mostrare tutte le
pagine di guida corrispondenti a
.B nome,
non solo la prima.
.TP
.B \-\^c
Riformatta la pagina di guida sorgente, anche quando esiste una
pagina formattata aggiornata. Questa opzione � utile se la pagina �
stata formattata per uno schermo con un numero diverso di colonne.
.TP
.B \-\^d
Non mostra la pagina di guida, ma stampa alcune informazioni diagnostiche.
.TP
.B \-\^D
Mostra sia la pagina che le informazioni diagnostiche.
.TP
.B \-\^f
Equivalente a
.BR whatis .
.TP
.BR \-\^F " o " \-\-preformat
Formatta solamente: non mostra niente.
.TP
.B \-\^h
Stampa una riga di aiuto ed esce.
.TP
.B \-\^k
Equivalente a
.B apropos.
.TP
.B \-\^K
Ricerca una stringa specifica in *tutte* le pagine di guida.
Attenzione: questo � probabilmente molto lento! Pu� essere di aiuto
specificare una sezione (solo per dare un'idea, nella mia macchina
questo porta via circa un minuto per 500 pagine di guida).
.TP
.B \-\^m " sistema"
Specifica un insieme alternativo di pagine di guida da cercare basato sul
nome di sistema dato.
.TP
.B \-\^p " stringa"
Specifica la sequenza di preprocessori da eseguire prima di nroff o
troff. Non tutte le installazioni hanno l'insieme completo di
preprocessori. Alcuni preprocessori e le lettere usate per designarli
sono: eqn (e), grap (g), pic (p), tbl (t), vgrind (v), refer (r).
Questa opzione sovrascrive la variabile d'ambiente
.BR MANROFFSEQ .
.TP
.B \-\^t
Usa
.B @troff@
per formattare la pagina di guida, mandando l'output allo
.BR stdout .
L'output di
.B @troff@
potrebbe aver bisogno di passare attraverso filtri o altro prima di
essere stampato.
.TP
.B \-\^w \fRo\fP \-\-path
Non mostra subito la pagina di guida, ma stampa la posizione dei file
che dovrebbero essere formattati o visualizzati. Se non � dato nessun
argomento mostra (sullo stdout) la lista di directory in cui
.B man
esegue la ricerca per le pagine di guida. Se
.B manpath
� un link a man, allora "manpath" � equivalente a "man --path".
.TP
.B \-\^W
Come \-\^w, ma stampa i nomi dei file uno per riga, senza ulteriori
informazioni. Questo � utile in comandi di shell tipo
.ft CW
man -aW man | xargs ls -l.
.ft
.SH "PAGINE FORMATTATE"
Man tenter� di salvare le pagine di guida formattare, in modo da
risparmiare il tempo di formattazione la volta successiva che quelle
pagine saranno necessarie. Tradizionalmente, le versioni formattate
delle pagine in DIR/manX sono salvate in DIR/catX, ma altri tipi di
mappatura possono essere specificati in /usr/lib/man.config.
Le pagine formattate non sono salvate quando la directory cat
corrispondente non esiste.
.PP
� possibile rendere man suid all'utente man. Quindi, se una directory
cat ha proprietario man e permessi 0755 (scrivibile solo da man), e i
file formattati hanno proprietario man e permessi 0644 o 0444
(scrivibili solo da man, o non scrivibili affatto), nessun utente
ordinario pu� cambiare le pagine formattate o mettere altri file
nella directory cat. Se man non � suid, allora la directory cat deve
avere i permessi 0777 se tutti gli utenti devono essere abilitati a
lasciare l� le pagine formattate.
.PP
L'opzione -c forza la formattazione di una pagina, anche se esiste una
pagina formattata di recente.
.SH AMBIENTE
.TP
.B MANPATH
Se
.B MANPATH
� impostata, il suo valore � usato come percorso di ricerca per le
pagine di guida.
.TP
.B MANROFFSEQ
Se
.B MANROFFSEQ
� impostata, il suo valore � usato per determinare l'insieme di
preprocessori da eseguire prima di nroff o troff. Per default, le
pagine sono passate attraverso il preprocessore di tabelle prima di
nroff.
.TP
.B MANSECT
Se
.B MANSECT
� impostata, il suo valore � usato per determinare quale sezione del
manuale usare per la ricerca.
.TP
.B MANWIDTH
Se
.B MANWIDTH
� impostata, il suo valore � usato per la larghezza con cui le pagine
di guida dovrebbero essere visualizzate. Altrimenti le pagine saranno
mostrate utilizzando la dimensione intera dello schermo.
.TP
.B MANPAGER
Se
.B MANPAGER
� impostata, il suo valore � usato come nome del programma da usare
per mostrare le pagine di guida. Altrimenti viene usato il valore di
.BR PAGER .
Se neanche questa � impostata, viene usato
.BR @pager@ .
.TP
.B LANG
Se
.B LANG
� impostata, il suo valore definisce il nome della sottodirectory
dove man cerca prima per le pagine di guida. Cos� il comando `LANG=it
man 1 foo' fa in modo che man cerchi la pagina di guida di foo in
.../it/man1/foo.1, e se non la trova in .../man1/foo.1, dove ... la
directory nel percorso di ricerca.
.TP
.B "NLSPATH, LC_MESSAGES, LANG"
Le variabili d'ambiente
.B NLSPATH
e
.B LC_MESSAGES
(o
.B LANG
quando l'ultima non esiste)
giocano un ruolo nella localizzazione del catalogo messaggi
(ma i messaggi inglesi sono compilati, e per l'inglese non �
richiesto il catalogo).
Notare che programmi tipo col(1) chiamati da man usano anche
LC_CTYPE.
.TP
.B PATH
.B PATH
� usata nella costruzione del percorso di ricerca di default per le
pagine di guida.
.TP
.B SYSTEM
.B SYSTEM
� usata per ottenere il nome di sistema alternativo (per l'uso con
l'opzione
.BR \-m ).
.SH "VEDERE ANCHE"
apropos(1), whatis(1), less(1), groff(1).
.SH BACHI
L'opzione
.B \-t
funziona solo se � installato un programma simile a troff.
.br
Se compaiono dei \e255 lampeggianti o <AD> al posto dei trattini, si
ponga la variabile ambientale `LESSCHARSET=latin1'.
.SH CONSIGLI
Se si aggiunge la riga
(global-set-key [(f1)] (lambda () (interactive) (manual-entry (current-word))))
nel proprio file
.IR .emacs ,
allora il tasto F1 produrr� la pagina di manuale corrispondente alla
chiamata di libreria su cui � posizionato il cursore.

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

JavaScript is required for this form.





No, thanks