|
man(1) manual page
Table of Contents
man - formatta e mostra le pagine di guida in linea
manpath - determina
i percorsi di ricerca dell'utente per le pagine di guida
man
[-adfhkKtwW] [-m sistema] [-p stringa] [-C file_configurazione] [-M percorso]
[-P impaginatore] [-S lista_sezioni] [sezione] nome ...
man formatta
e mostra le pagine di guida in linea. Questa versione riconosce le variabili
d'ambiente MANPATH e (MAN)PAGER, in modo da avere il proprio set di pagine
di guida e scegliere il programma preferito per leggere le pagine formattate.
Se sezione è specificata, 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 nome contiene un carattere /, allora questo viene prima provato come
se fosse il nome di un file, in modo da poter fare man ./foo.5 o anche man
/cd/foo/bar.1.gz .
- -C " file_configurazione"
- Specifica il file
man.config da usare; il valore di default è /usr/lib/man.config. (Vedere
man.config(5)
.)
- -M " percorso"
- Specifica la lista di directory in cui cercare
le pagine di guida. Se questa opzione manca, viene usata la variabile d'ambiente
MANPATH. Se tale variabile d'ambiente non ci fosse, l'elenco di default è
trovato consultando /usr/lib/man.config. Una sottostringa vuota di MANPATH
denota la lista di default.
- -P " impaginatore"
- Specifica il programma di
impaginazione da usare. Per default man usa /usr/bin/less -is. Questa opzione
sovrascrive la variabile d'ambiente MANPAGER, che sovrascrive a sua volta
la variabile PAGER.
- -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 MANSECT.
- -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 nome, non solo la
prima.
- -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.
- -d
- Non mostra
la pagina di guida, ma stampa alcune informazioni diagnostiche.
- -D
- Mostra
sia la pagina che le informazioni diagnostiche.
- -f
- Equivalente a whatis.
- -h
- Stampa una riga di aiuto ed esce.
- -k
- Equivalente a apropos.
- -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.)
- -m " sistema"
- Specifica un insieme alternativo
di pagine di guida da cercare basato sul nome di sistema dato.
- -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 MANROFFSEQ.
- -t
- Usa /usr/bin/groff -Tps -mandoc per formattare
la pagina di guida, mandando l'output allo stdout. L'output di /usr/bin/groff
-Tps -mandoc potrebbe aver bisogno di passare attraverso filtri o altro
prima di essere stampato.
- -w o --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 man esegue la ricerca per le pagine di guida. Se manpath è un link
a man, allora "manpath" è equivalente a "man --path".
- -W
- Come -w, ma stampa
i nomi dei file uno per riga, senza ulteriori informazioni. Questo è utile
in comandi di shell tipo man -aW man | xargs ls -l.
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 corriposndente non esiste.
È 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.
L'opzione -c forza la formattazione di una pagina,
anche se esiste una pagina formattata di recente.
- MANPATH
- Se
MANPATH è impostata, il suo valore è usato come percorso di ricerca per
le pagine di guida.
- MANROFFSEQ
- Se 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.
- MANSECT
- Se MANSECT è impostata, il suo valore
è usato per determinare quale sezione del manuale usare per la ricerca.
- MANWIDTH
- Se 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.
- MANPAGER
- Se MANPAGER è impostata, il suo valore è usato come nome del
programma da usare per mostrare le pagine di guida. Altrimenti viene usato
il valore di PAGER. Se neanche questa è impostata, viene usato /usr/bin/less
-is.
- LANG
- Se LANG è impostata, il suo valore definisce il nome della sottodirectory
dove man cerca prima per le pagine di guida. Così il comando `LANG=dk man
1 foo' fa in modo che man cerchi la pagina di guida di foo in directory
nel percorso di ricerca.
- NLSPATH, LC_MESSAGES, LANG
- Le variabili d'ambiente
NLSPATH e LC_MESSAGES (o 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.
- PATH
- PATH è usata nella
costruzione del percorso di ricerca di default per le pagine di guida.
- SYSTEM
- SYSTEM è usata per ottenere il nome di sistema alternativo (per
l'uso con l'opzione -m).
apropos(1)
, whatis(1)
, less(1)
, groff(1)
.
L'opzione -t funziona solo se è installato un programma simile a
troff.
Table of Contents
|
