NOME¶
catman - crea o aggiorna le pagine di manuale preformattate
SINTASSI¶
catman [
-dhV] [
-M percorso] [
sezione] ...
DESCRIZIONE¶
catman è usato per creare un insieme aggiornato di pagine di
manuale preformattate dette anche
cat page. Le cat page sono
generalmente più veloci da visualizzare rispetto alle pagine di manuale
originali, ma richiedono ulteriore spazio per essere memorizzate. La decisione
di supportare le cat page è dell'amministratore locale, il quale deve
fornire anche le directory adatte per contenerle.
Le opzioni disponibili a
catman sono le gerarchie delle pagine di manuale
e le sezioni da preformattare. Le gerarchie predefinite sono quelle
specificate come globali nel file di configurazione di man-db e le sezioni
predefinite sono gli elementi separati da `:' nella variabile d'ambiente
$
MANSECT oppure, se $
MANSECT non è definita, un insieme
predefinito in fase di compilazione all'interno di
man. Fornendo a
catman un insieme di nomi di sezioni separati da spazi bianchi le due
precedenti liste di sezioni verranno ignorate.
catman fa uso della cache della base di dati
index associata con
ognuna delle gerarchie per determinare quali file hanno bisogno della
formattazione.
OPZIONI¶
- -d, --debug
- Mostra informazioni utili al debug.
- -M percorso, --manpath=percorso
- Specifica una lista alternativa di percorsi di ricerca separati da `:'. Di
default, questi sono tutti i percorsi indicati come globali nel file di
configurazione di man-db.
- -h, --help
- Mostra un messaggio d'aiuto ed esce.
- -V, --version
- Mostra informazioni sulla versione e sull'autore.
VARIABILI D'AMBIENTE¶
- MANSECT
- Se $MANSECT è definita, il suo valore è una lista
separata da `:' di sezioni ed è usato per determinare in quali
sezioni di manuali fare la ricerca e in che ordine.
- MANPATH
- Se $MANPATH è definita, il suo valore è interpretato
come una lista di percorsi di ricerca separati da `:' di gerarchie di
pagine di manuale.
FILE¶
- /etc/manpath.config
- File di configurazione di man-db.
- /usr/man/index.(bt|db|dir|pag)
- Una cache della base di dati globale index tradizionale.
- /var/catman/index.(bt|db|dir|pag)
- Una cache della base di dati globale index alternativa e conforme
con FSSTND.
VEDERE ANCHE¶
man(1),
manpath(5),
mandb(8).
AUTORE¶
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)