MAN
Section: Utility per le Pagine di Manuale (1)
Updated: 2020-06-22
Page Index
NOME
man - un'interfaccia ai manuali di riferimento in linea
SINTASSI
man
[
-c|
-w|
-tZ]
[
-H[
browser]]
[
-Tdispositivo]
[
-X[
dpi]]
[
-adhu7V]
[
-i|
-I]
[
-m
sistema[,...]]
[
-L
locale]
[
-p
stringa]
[
-C
file]
[
-M
percorso]
[
-P
paginatore]
[
-r
prompt]
[
-S
lista]
[
-e
estensione]
[[
sezione]
pagina ...] ...
man
-l
[
-7]
[
-tZT]
[
-H[
browser]]
[
-Tdispositivo]
[
-X[
dpi]]
[
-p
stringa]
[
-P
paginatore]
[
-r
prompt]
file
...
man
-k
[
apropos
opzioni]
espr_reg
...
man
-f
[
whatis
opzioni]
pagina
...
DESCRIZIONE
man
è il paginatore dei manuali del sistema. Di solito ognuno degli argomenti
pagina
dati a
man
è il nome di un programma, di un'utility o di una funzione.
La
pagina di manuale
associata con ognuno di questi argomenti è poi trovata e mostrata. Una
sezione,
se fornita, indirizzerà
man
a guardare solo in quella
sezione
del manuale.
L'azione predefinita è di ricercare in tutte le
sezioni
disponibili seguendo un ordine prestabilito e di mostrare solo la
prima
pagina
trovata, anche se
pagina
esiste in diverse
sezioni.
La seguente tabella mostra i numeri delle
sezioni
del manuale seguiti dai tipi di pagine che contengono
1 |
Programmi eseguibili e comandi della shell
|
2 |
Chiamate al sistema (funzioni fornite dal kernel)
|
3 |
Chiamate alle librerie (funzioni all'interno delle librerie di sistema)
|
4 |
File speciali (di solito trovabili in /dev)
|
5 |
Formati dei file e convenzioni p.es. /etc/passwd
|
6 |
Giochi
|
7 |
Pacchetti di macro e convenzioni p.es. man(7), groff(7).
|
8 |
Comandi per l'amministrazione del sistema (solitamente solo per root)
|
9 |
Routine del kernel [Non standard]
|
Una
pagina
di manuale consta di diverse parti.
Queste possono essere etichettate
NOME (NAME),
SINTASSI (SYNOPSIS),
DESCRIZIONE (DESCRIPTION),
OPZIONI (OPTIONS),
FILE (FILES),
VEDERE ANCHE (SEE ALSO),
PROBLEMI (BUGS)
e
AUTORE (AUTHOR).
Le seguenti convenzioni si applicano alla sezione
SINTASSI
e possono essere usate come una guida per le altre sezioni.
testo in grassetto |
scrivere esattamente come mostrato.
|
testo in corsivo |
rimpiazzare con un argomento appropriato.
|
[-abc] |
ognuno o tutti gli argomenti all'interno di [ ] sono opzionali.
|
-a|-b |
opzioni separate da | non possono essere usate assieme.
|
argomento ... |
argomento è ripetibile.
|
[espressione] ... |
l'intera espressione all'interno di [ ] è ripetibile.
|
L'illustrazione del comando o funzione è un modello che dovrebbe
corrispondere a tutte le possibili invocazioni. In alcuni casi è
preferibile illustrare diverse invocazioni che si escludono a vicenda
come mostrato nella sezione
SINTASSI
di questa pagina di manuale.
ESEMPI
- man ls
-
Mostra la pagina di manuale per la
voce
(programma)
ls.
- man -a intro
-
Mostra, in successione, tutte le pagine di manuale
intro
disponibili nel manuale. È possibile uscire tra due
visualizzazioni successive o saltarne una qualsiasi.
- man -t alias | lpr -Pps
-
Formatta la pagina di manuale indicata da
`alias',
solitamente una pagina di manuale della shell, nel formato predefinito di
troff
o
groff
e la redireziona, tramite pipe, alla stampante chiamata
ps.
L'output predefinito per
groff
è di solito in PostScript.
man --help
dovrebbe mostrare quale preprocessore è collegato con l'opzione
-t.
- man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
-
Questo comando decomprime e formatta il sorgente nroff della pagina di
manuale
./foo.1x.gz
in un file
device independent (dvi) .
La redirezione è necessaria in quanto l'opzione
-T
fa sì che l'output sia diretto verso lo
stdout
senza nessun paginatore. L'output può essere visto con un programma tipo
xdvi
o ulteriormente convertito in PostScript usando un programma tipo
dvips.
- man -k printf
-
Cerca la parola chiave
printf
nelle descrizioni brevi e nei nomi delle pagine considerandola una
espressione regolare.
Mostra qualsiasi corrispondenza.
Equivalente a
apropos -r printf.
- man -f smail
-
Cerca le pagine di manuale indicate da
smail
e mostra una breve descrizione di tutte quelle trovate.
Equivalente a
whatis -r smail.
PANORAMICA
Molte sono le opzioni disponibili per
man
in modo da fornire all'utente la maggior flessibilità
possibile. Possono essere fatti cambiamenti al percorso di ricerca,
all'ordine delle sezioni, al preprocessore per l'output, e ad altri
comportamenti e operazioni elencati in dettaglio più avanti.
Se impostate, alcune variabili d'ambiente sono interrogate per
determinare le funzionalità di
man.
È possibile impostare la variabile "omni comprensiva"
$MANOPT
ad una stringa qualsiasi nel formato della riga di comando, con
l'eccezione che ogni spazio che sia parte integrante dell'argomento
di un'opzione deve essere preceduto da un backslash (`\').
man
analizzerà
$MANOPT
prima di analizzare la propria riga di comando. Quelle opzioni che
richiedono un argomento, saranno ridefinite se le stesse opzioni si
trovano anche nella riga di comando. Per annullare tutte le
opzioni impostate in
$MANOPT,
può essere specificato
-D
come opzione iniziale della riga di comando.
Ciò permette a man di "dimenticare" le opzioni specificate in
$MANOPT
sebbene debbano restare ancora valide.
Le utility per le pagine di manuale raggruppate nel pacchetto
man-db
fanno un uso intenso delle cache di
index.
Tali cache contengono informazioni come la posizione di ogni pagina di
manuale nel filesystem e cosa contiene il relativo
whatis
(breve descrizione della pagina di manuale), inoltre permettono a
man
di cercare le pagine molto più velocemente rispetto ad una ricerca
su file system per ogni pagine da cercare.
Se richiesto tramite l'opzione
-u
man
può verificare che tali cache rimangano consistenti, in modo
da non dover lanciare manualmente del
software per aggiornare le tradizionali basi di dati di
whatis.
Se
man
non può trovare una base di dati
index
inizializzato da
mandb
per una particolare gerarchia di pagine di manuale, cercherà comunque
la pagina di manuale richiesta sebbene sarà necessario un globbing dei
file per effettuare la ricerca all'interno di quella gerarchia (N.d.T:
con globbing [jargon] si intende l'espansione dei caratteri speciali
all'interno di un nome costruito con wildcard - caratteri jolly).
Invece se
whatis
o
apropos
non trovano la base di dati
index,
proveranno comunque a estrarre le informazioni dalla base di dati
whatis
tradizionale.
Queste utility supportano i file sorgente nroff compressi, che abbiano,
di default, una fra le seguenti estensioni
.Z, .z e .gz.
È possibile trattare con qualsiasi estensione di file compresso, ma
questa informazione deve essere nota al momento della compilazione.
Inoltre, normalmente, qualsiasi pagina cat prodotta è compressa usando
gzip.
Ognuna delle gerarchie `globali' delle pagine di manuale, come
/usr/share/man
o
/usr/X11R6/man,
può avere una directory qualsiasi come gerarchia delle pagine cat.
Tradizionalmente le pagine cat sono salvate sotto la stessa gerarchia
delle pagine di manuale, ma per ragioni come quelle specificate nel
Linux File System Standard (FSSTND),
è meglio salvarle da qualche altra parte. Per i dettagli su come ciò
sia possibile, si legga
manpath(5).
Per i dettagli sul perché fare ciò, si legga lo standard.
Con questo pacchetto è disponibile il ``supporto internazionale'': le
pagine di manuale nella lingua nativa sono accessibili (se disponibili
nel proprio sistema) usando le funzioni
locale.
Per attivare tale supporto, è necessario impostare
$LC_MESSAGES e
$LANG
o qualche altra variabile d'ambiente dipendente dal sistema, alla propria
lingua locale, solitamente specificata nel formato basato sul
POSIX 1003.1:
<lingua>[_ <zona>[.<set-di-caratteri>[,<versione>]]]
Se la pagina desiderata è disponibile nel proprio
locale,
sarà mostrata al posto della pagina standard (di solito in Inglese
Americano).
Il supporto internazionale per i cataloghi di messaggi è un'altra
caratteristica di questo pacchetto e può essere attivato, sempre se
disponibile, nello stesso modo. Se si trova che le pagine di manuale e
i cataloghi dei messaggi forniti con questo pacchetto non sono
disponibili per la propria lingua e si vuole fornirli, si contatti
il manutentore il quale coordinerà tali attività.
Per informazioni riguardanti altre caratteristiche ed estensioni
disponibili con questo paginatore dei manuali, si leggano i documenti
forniti con il pacchetto.
COMPORTAMENTO PREDEFINITO
man
cercherà la pagina di manuale desiderata all'interno delle cache delle
basi di dati
index.
Se l'opzione
-u
viene specificata, è eseguita una verifica della
consistenza della cache per assicurarsi che le basi di dati riflettano
accuratamente il filesystem. Non è generalmente necessario eseguire
mandb
dopo che le cache sono state create inizialmente, finché una di questa
non sia in qualche modo corrotta.
Il controllo della cache su sistemi con molte pagine di manuale può
essere piuttosto lungo; per questo non viene svolto automaticamente, ma
gli amministratori di sistema possono esseguire
mandb
settimanalmente per aggiornare la base di dati.
Per superare eventuali problemi causati da cache non aggiornate
man
passa automaticamente al `file globbing' se una ricerca nella cache
non ha esito, allo stesso modo di quando la cache non è presente.
Una volta che una pagina di manuale è stata localizzata, è eseguita
una verifica per scoprire se il relativo file `cat' preformattato
esiste già e se è più recente del file nroff. Se è così, questo file
preformattato è (di solito) decompresso e poi visualizzato tramite un
paginatore. Il paginatore può essere specificato in diversi modi
oppure viene usato quello predefinito (si veda l'opzione
-P
per i dettagli). Se non c'è la pagina cat o è più vecchia del file
nroff, quest'ultimo è filtrato attraverso vari programmi ed è mostrato
immediatamente.
Se può essere prodotto un file cat (esiste la relativa directory cat e
ha i permessi appropriati),
man
comprimerà e salverà il file cat in background.
Quanti e quali filtri usare viene determinato in svariati modi. Per prima cosa è
interrogata l'opzione della riga di comando
-p
o la variabile d'ambiente
$MANROFFSEQ.
Se
-p
non è usata e la variabile d'ambiente non è impostata, viene analizzata
la riga iniziale del file troff per cercare una "stringa
preprocessore". Per contenere una stringa preprocessore valida, la
prima riga deve assomigliare a
'\
<stringa>
dove
stringa
può essere una combinazione qualsiasi delle lettere descritte più
avanti dall'opzione
-p.
Se nessuno dei metodi suddetti fornisce informazioni sui filtri, ne è
usato un insieme predefinito.
Una pipeline di formattazione è creata dai filtri al formattatore
primario
(nroff
o
[tg]roff
con
-t)
ed eseguita.
Alternativamente, se esiste un programma eseguibile
mandb_nfmt
(o
mandb_tfmt
con
-t)
nella radice dell'albero dei manuali, questo è eseguito. Gli viene
passato il file sorgente del manuale, la stringa preprocessore, ed
eventualmente il dispositivo specificato come argomento di
-T o -E.
OPZIONI
Le opzioni che non richiedono argomenti, duplicate nelle riga di
comando, in
$
MANOPT,
o in entrambe sono dannose. Per le opzioni che richiedono un argomento,
ogni duplicazione annullerà il valore del precendente argomento.
- -l, --local-file
-
Attiva il modo `locale'. Formatta e visualizza file di manuale locali
invece di effettuare una ricerca nella collezione di manuali del
sistema. Ogni argomento pagina sarà interpretato come un file sorgente
nroff nel formato corretto.
Non è creato il file cat. Se '-' è elencato fra gli argomenti,
l'input sarà preso dallo stdin.
Quando non è usata questa opzione, e man non trova la pagina
richiesta, prima di mostrare un messaggio d'errore, prova a
comportarsi come se fosse fornita questa opzione, usando il nome come
nome di un file e cercando una corrispondenza esatta.
- -L locale, --locale=locale
-
man
di solito determinerà il proprio locale attuale chiamando la funzione C
setlocale(3)
che interroga diverse variabili d'ambiente, tra le quali
$LC_MESSAGES
e
$LANG.
Per ridefinire temporaneamente il valore così determinato, si usi
questa opzione per fornire direttamente una stringa
locale
a
man.
Si noti che ciò non avrà effetto finché non è iniziata realmente una
ricerca. L'output, come ad esempio il messaggio d'aiuto, sarà sempre
visualizzato nel locale determinato inizialmente.
- -D, --default
-
Questa opzione è solitamente data come prima opzione e reinizializza
il comportamento di
man
a quello predefinito. È usata per reinizializzare quelle opzioni che possono
essere state impostate in
$MANOPT.
Qualsiasi opzione successiva
-D
avrà il solito effetto.
- -C file, --config-file=file
-
Usa il file di configurazione speficiato al posto di
~/.manpath.
- -M percorso, --manpath=percorso
-
Specifica un percorso man alternativo. Normalmente
man
usa il codice derivato da
manpath
per determinare il percorso di ricerca. Questa opzione ha priorità
sulla variabile d'ambiente
$MANPATH
e fa sì che questa e l'opzione
-m
siano ignorate.
Un percorso specificato come manpath deve essere la radice di una
gerarchia di pagine di manuali strutturate in sezioni come descritto
nel manuale di man-db (nella sezione "The manual page system").
Per vedere le pagine di manuali esterne a questa gerarchia, si usi
l'opzione
-l .
- -P paginatore, --pager=paginatore
-
Specifica quale paginatore dell'output usare. Normalmente
man
usa
less.
Questa opzione ha priorità sulla variabile d'ambiente
$PAGER
e non va usata assieme con
-f
o
-k.
- -r prompt, --prompt=prompt
-
Se una versione recente di
less
è usata come paginatore,
man
proverà ad impostare il suo prompt e alcune sue opzioni.
Il prompt predefinito assomiglierà a
Pagina di Manuale nome(sez) riga x
dove
nome
denota il nome della pagina di manuale,
sez
denota la sezione in cui è stata trovata e
x
è il numero di riga corrente.
Ciò è ottenuto usando la variabile d'ambiente
$LESS.
Fornendo l'opzione
-r
seguita da una stringa si può modificare il prompt predefinito.
La stringa può contenere il testo
$MAN_PN
il quale sarà espanso nel nome della pagina di manuale corrente e il
nome della sua sezione racchiuso tra `(' e `)'. La stringa usata per
produrre il default potrebbe essere espressa come
\ Pagina\ di\ Manuale\ \$MAN_PN\ ?ltriga\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (FINE):?pB %pB\\%..
È stata spezzata in due righe solo per migliorarne la leggibilità. Per
il suo significato si veda la pagina di manuale
less(1).
La stringa di prompt per prima cosa è valutata dalla shell. Perciò le
doppie virgolette `"', le virgolette rovesce ``' e i backslash `\'
devono essere preceduti da `\'. La stringa di prompt potrebbe
terminare con un `\$' il quale può essere seguito da ulteriori
opzioni per less. Di default
man
imposta le opzioni
-ix8.
Se si vuole eliminare completamente la gestione del prompt da
parte di
man
si faccia uso della variabile d'ambiente
$MANLESS
descritta sotto.
- -7, --ascii
-
Quando visualizza una pagina di manuale in
ascii(7)
puro su di un terminale a 7 bit o su un emulatore di terminale, alcuni
caratteri potrebbero non essere visualizzati correttamente se si usa
il descrittore di dispositivo
latin1(7)
con il
GNU
nroff.
Questa opzione permette alle pagine di manuale in
ascii
puro di essere visualizzate in
ascii
con il dispositivo
latin1.
Non tradurrà alcun testo
latin1.
La seguente tabella mostra le traduzioni effettuate: alcune parti
di essa potrebbero essere mostrate in maniera corretta solo usando
il dispositivo
latin1(7)
di
GNU
nroff.
Descrizione | Ottale | latin1 | ascii
|
|
trattino di continuazione | 255 | | -
|
bullet (middle dot) | 267 | • | o
|
accento acuto | 264 | ´ | '
|
segno di moltiplicazione | 327 | × | x
|
Se la colonna
latin1
è visualizzata correttamente, il proprio terminale può essere
configurato per i caratteri
latin1
e questa opzione non è necessaria.
Se le colonne
latin1
e
ascii
sono identiche, si sta leggendo questa pagina usando questa opzione
oppure
man
non l'ha formattata usando il descrittore di dispositivo
latin1.
Se manca la colonna
latin1
o è corrotta, può essere necessario visualizzare le pagine di manuale
usando questa opzione.
Questa opzione è ignorata quando si usano le opzioni
-t,
-H,
-T
o
-Z
e può essere inutile per
nroff
diversi dalla versione
GNU.
- -S lista, --sections=lista
-
Lista è un elenco ordinato di sezioni di manuale su
cui effettuare la ricerca. Usando questa opzione viene ignorata la
variabile d'ambiente
$MANSECT.
- -a, --all
-
Normalmente,
man
uscirà dopo aver visualizzato la pagina di manuale più adatta che
trova. Usando questa opzione si forza
man
a visualizzare tutte le pagine di manuale con i nomi che corrispondono
al criterio di ricerca.
- -c, --catman
-
Questa opzione non è di uso generale e dovrebbe essere usata solo dal
programma
catman.
- -d, --debug
-
Non mostra alcuna pagina di manuale, ma mostra un sacco di
informazioni per il debug.
- -e sotto-estensione, --extension=sotto-estensione
-
Alcuni sistemi incorporano nella gerarchia principale delle pagine di
manuale grossi pacchetti di pagine di manuale, come quelle che
accompagnano il pacchetto
Tcl.
Per ovviare ai problemi dovuti alla presenza di pagine di manuale con
lo stesso nome come
exit(3),
le pagine di
Tcl
sono di solito assegnate alla sezione
l.
Poiché questa non è una scelta fortunata, è ora possibile mettere le
pagine nella sezione corretta, ed in questo caso assegnare
l'estensione specifica
exit(3tcl).
Durante il funzionamento normale,
man
visualizzerà
exit(3)
piuttosto che
exit(3tcl).
Per trattare questa situazione ed evitare la necessità di sapere in
quale sezione di trova la pagina di manuale richiesta, è ora possibile
dare a
man
una stringa di
sotto-estensione
che indica a quale pacchetto deve appartenere la pagina. Usando il
precedente esempio, passando l'opzione
-e tcl
a
man
verrà ristretta la ricerca alle pagine che hanno estensione
*tcl.
- -f, --whatis
-
Equivalente a
whatis.
Mostra, se disponibile, una breve descrizione tratta della pagine di
manuale. Si veda
whatis(1)
per i dettagli.
- -h, --help
-
Mostra un messaggio d'aiuto ed esce.
- -i, --ignore-case
-
Non fa distinzione tra maiuscole e minuscole durante la ricerca della
pagine. Questo è il comportamento normale
- -I, --match-case
-
Effettua la ricerca della pagina facendo distinzione tra lettere
minuscole e maiuscole.
- -k, --apropos
-
Equivalente a
apropos.
Cerca nelle descrizioni brevi delle pagine di manuale le occorrenze
delle parole chiave e visualizza qualsiasi corrispondenza. Si veda
apropos(1)
per i dettagli.
-m
sistema [,...],
--systems=sistema[,...]
-
Se questo sistema ha accesso alle pagine di manuale di altri sistemi
operativi, si può accedere a quest'ultime usando questa opzione. Per
cercare una pagina di manuale nella collezione delle pagine di manuale
di NewOS, si usi l'opzione
-m
NewOS.
Il
sistema
specificato può essere una combinazione di nomi di sistemi operativi
separati da virgole. Per includere una ricerca fra le pagine di
manuale del sistema operativo nativo, si includa il nome di sistema
man
nella stringa argomento. Usando questa opzione verrà ignorata la
variabile d'ambiente
$SYSTEM.
- -p stringa, --preprocessor=stringa
-
Specifica la sequenza di preprocessori da lanciare prima di
nroff
o
troff/groff.
Non tutte le installazioni avranno l'insieme completo di
preprocessori. Alcuni dei preprocessori e le lettere che li designano
sono:
eqn (e),
grap (g),
pic (p),
tbl (t),
vgrind (v),
refer (r).
Usando questa opzione viene ignorata la variabile d'ambiente
$MANROFFSEQ.
zsoelim
è sempre lanciato come primo preprocessore.
- -u, --update
-
Questa opzione fa in modo che
man
effettui un controllo a livello di `inode' sulla propria base di dati
per assicurarsi che sia una accurata rappresentazione del file system.
Il suo effetto è positivo solo se
man
è installato con il bit setuid impostato.
- -t, --troff
-
Usa
groff -mandoc
per formattare la pagina di manuale nello stdout. Questa opzione non è
richiesta assieme a
-H,
-T
o
-Z.
- -T[dispositivo], --troff-device[=dispositivo]
-
Questa opzione è usata per cambiare l'output di
groff
(o se possibile quello di
troff)
per adattarlo ad un dispositivo diverso da quello predefinito. Implica
-t.
Esempi (forniti con Groff-1.17) comprendono
dvi, latin1, ps, utf8,
X75 e X100.
- -X[dpi], --gxditview[=dpi]
-
Questa opzione mostra l'output di
groff
in una finestra grafica usando il programma
gxditview.
dpi
(punti per pollice) può essere 75, 75-12, 100 o 100-12, con valore
predefinito 75; le varianti -12 usano un font da 12 punti.
Questa opzione implica
-T
con i dispositivi X75, X75-12, X100, X100-12 rispettivamente.
- -Z, --ditroff
-
groff
lancerà
troff
e poi userà un appropriato post-processore per produrre un output
adatto per il dispositivo scelto. Se
groff -mandoc
è
groff,
questa opzione è passata a
groff
e verrà soppresso l'uso del post-processore. Implica
-t.
- -H[browser], --html[=browser]
-
Questa opzione indica a
groff
di produrre un output HTML, e mostra tale output in un browser
web. La scelta del browser è opzionale ed è determinata
dall'argomento opzionale
browser
se questo è fornito; altrimenti dalla variabile
$BROWSER
oppure dal valore definito durante la compilazione (in genere
lynx).
Questa opzione implica
-t,
e funziona solo con la versione
GNU
di
troff.
- -E dispositivo, --encoding=dispositivo
-
Genera un output usando una codifica di caratteri diversa dal
valore predefinito. Per il modo nel quale
nroff
è strutturato, l'argomento di questa opzione deve essere un
dispositivo di
nroff
come
ascii, latin1 o utf8.
- -w, --where, --location
-
Non mostra veramente le pagine di manuale, ma stampa le posizioni dei
file che sarebbero stati formattati.
- -W, --where-cat, --location-cat
-
Non mostra veramente le pagine di manuale, ma stampa le posizioni dei
file cat che sarebbero stati visualizzati.
Se entrambi -w e -W vengono specificati, li stampa separati da uno spazio.
- -V, --version
-
Mostra informazioni sulla versione.
STATI D'USCITA
- 0
-
L'esecuzione del programma ha avuto successo.
- 1
-
Errore d'uso, di sintassi o nel file di configurazione.
- 2
-
Errore operativo.
- 3
-
Un processo figlio ha restituito uno stato d'uscita diverso da zero.
- 16
-
Almeno una delle pagine/file/parole chiave non esisteva o non aveva
corrispondenza.
VARIABLI D'AMBIENTE
- MANPATH
-
Se
$MANPATH
è impostata, il suo valore è usato come percorso per la ricerca delle
pagine di manuale.
- MANROFFSEQ
-
Se
$MANROFFSEQ
è impostata, il suo valore è usato per determinare l'insieme dei
preprocessori attraverso i quali va passata la pagina di manuale. La
lista dei preprocessori predefiniti dipende dal sistema.
- MANSECT
-
Se
$MANSECT
è impostata, il suo valore è una lista separata da `:' di sezioni ed è
usata per determinare in quali sezioni di manuale cercare e in quale
ordine.
- PAGER
-
Se
$PAGER
è impostata, il suo valore è usato come il nome del programma da usare
per visualizzare la pagina di manuale. Di default, è usato
less.
- MANLESS
-
Se
$MANLESS
è impostata,
man
non effettuerà alcuna operazione per impostare una stringa di prompt
per il pager
less.
Invece, il valore di
$MANLESS
verrà passato senza modifiche
$LESS.
Ad esempio, per impostare il prompt a
"la mia stringa prompt", impostare
$MANLESS
to
'-Psla mia stringa prompt'.
- BROWSER
-
Se
$BROWSER
è impostata, il suo valore deve essere una lista di comandi separati
da virgole, ciascuno dei quali viene provato nell'ordine per cercare
di eseguire un browser web per
man
--html.
In ogni comando
%s
viene sostituito da un nome di file contiene l'output HTML di
groff,
%%
viene sostituito da un singolo carattere di percento, e
%c
viene sostituito dal carattere di due punti.
- SYSTEM
-
Se
$SYSTEM
è impostata, avrà lo stesso effetto dell'opzione
-m stringa
dove stringa sarà preso come il contenuto di
$SYSTEM.
- MANOPT
-
Se
$MANOPT
è impostata, sarà analizzata prima della riga di comando di
man
ed è supposta essere in formato simile. Poiché tutte le altre
variabili d'ambiente specifiche di
man
possono essere specificate come opzioni della riga di comando, e sono
quindi candidate per essere incluse in
$MANOPT
ci si può aspettare che diventeranno obsolete.
N.B.: Tutti gli spazi che dovrebbero essere interpretati come parte
dell'argomento di un opzione devono essere preceduti da `\'.
- MANWIDTH
-
Se
$MANWIDTH
è impostata, il suo valore sarà utilizzato come lunghezza della riga
per il quale le pagine di manuale verranno formattate. Se non viene
impostata, le pagine saranno formattate usando una lunghezza appropriata
al terminale in uso (tramite
ioctl(2)
se disponibile, oppure il valore di
$COLUMNS,
o ancora usando il valore 80 se nessuno dei due metodi precedenti
funziona).
Le pagine cat verranno salvate solo le la lunghezza della linea di
terminale si trova tra 66 e 80 caratteri.
- LANG, LC_MESSAGES
-
A seconda del sistema e dell'implementazione, una o entrambe le variabili
$LANG
e
$LC_MESSAGES
saranno interrogate per determinare il locale corrente.
man
visualizzerà i suoi messaggi usando quel locale (se disponibile). Si veda
setlocale(3)
per i dettagli.
FILE
- /etc/man_db.conf
-
File di configurazione di man-db.
- /usr/share/man
-
Una gerarchia di pagine di manuale globale.
- /usr/share/man/index.(bt|db|dir|pag)
-
Una cache della base di dati globale
index
tradizionale.
- /var/cache/man/index.(bt|db|dir|pag)
-
Una cache della base di dati globale
index
alternativa e conforme con FSSTND.
VEDERE ANCHE
mandb(8),
manpath(1),
manpath(5),
apropos(1),
whatis(1),
catman(8),
less(1),
nroff(1),
troff(1),
groff(1),
zsoelim(1),
setlocale(3),
man(7),
ascii(7),
latin1(7),
la pagina del pacchetto man-db,
FSSTND.
CRONOLOGIA
1990, 1991 - Originalmente scritta da John W. Eaton (
jwe@che.utexas.edu).
23 Dicembre 1992: Rik Faith (faith@cs.unc.edu) applica le soluzioni ai
problemi fornite da Willem Kasdorp (wkasdo@nikhefk.nikef.nl).
30 Aprile 1994 - 23 Febbraio 2000: Wilf.
(G.Wilford@ee.surrey.ac.uk) ha iniziato lo sviluppo e il mantenimento
di questo pacchetto con l'aiuto di un po' di gente.
30 Ottobre 1996 - 30 Marzo 2001: Fabrizio Polacco <fpolacco@debian.org>
mantiene e migliora questo pacchetto per il progetto Debian, con
l'aiuto di tutta la comunità.
31 Marzo 2001 - presente: Colin Watson <cjwatson@debian.org>
Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)
Aggiornamento di Giuseppe Sacco <eppesuig@debian.org>