Manpages

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