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
AUTORE
Wilf.
(G.Wilford [AT] ee.uk).
Fabrizio Polacco (fpolacco [AT] debian.org).
Traduzione di Bortolozzo Giovanni (borto [AT] pluto.it)