NOME¶

apropos - ricerca nei nomi e nelle descrizioni delle pagine di manuale

SINTASSI¶

apropos [-dhV] [-e|-w|-r] [-m sistema[,...]] [-M percorso] [-C file] parola_chiave ...

DESCRIZIONE¶

Ogni pagina di manuale ha disponibile al suo interno una breve descrizione. apropos ricerca nelle descrizioni le istanze di parola_chiave.

parola_chiave è solitamente una espressione regolare, come se fosse usata l'opzione (-r) oppure può contenere wildcard ("caratteri jolly") (-w), o corrispondere esattamente ad una parola (-e). Usando queste opzioni, potrebbe essere necessario racchiudere tra virgolette (') la parola_chiave o far precedere da backslash (\) i caratteri speciali per evitare che la shell provi a interpretarla(i).

Le regole di corrispondenza predefinite permettono la ricerca della corrispondenza sia nel nome della pagina che in parole complete nella descrizione.

OPZIONI¶

-d, --debug

Mostra informazioni utili al debug.

-v, --verbose

Stampa messaggi di errore dettagliati.

-r, --regex

Interpreta ogni parola chiave come un'espressione regolare. Questo è il comportamento predefinito. Di ogni parola chiave sarà cercata la corrispondenza fra i nomi delle pagine e le descrizioni indipendentemente. Può corrispondere ad una parte qualsiasi di entrambe. La corrispondenza non è limitata a parole intere.

-w, --wildcard

Interpreta ogni parola chiave come un modello (pattern) contenente wildcard nello stile della shell. Di ogni parola chiave sarà cercata la corrispondenza fra i nomi delle pagine e le descrizioni indipendentemente. Se anche --exact è usato, allora è trovata una corrispondenza solo se la parola chiave espansa corrisponde ad un'intera descrizione o nome di pagina. In alternativa è anche permesso che la corrispondenza sia su una parte della descrizione che contenga parole intere.

-e, --exact

Di ogni parola chiave sarà cercata la corrispondenza esatta tra i nomi delle pagine e le descrizioni.

-m sistema[,...], --systems=sistema[,...]

-M percorso, --manpath=percorso

Specifica un'insieme di ricerca alternativo di gerarchie di percorsi di pagine di manuale separate da `:'. Di default, apropos usa la variabile d'ambiente $MANPATH finché questa non è vuota o non definita, nel qual caso determinerà un'appropriato percorso basato sulla propria variabile d'ambiente $PATH. Usando questa opzione verrà ignorato il contenuto di $MANPATH.

-C file, --config-file=file

Usa il file di configurazione specificato piuttosto che quello predefinito, cioè ~/.manpath.

-h, --help

Mostra un messaggio d'aiuto ed esce.

-V, --version

Mostra informazioni sulla versione e sull'autore.

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.

16

Non è stato trovato niente che corrisponde al criterio specificato.

VARIABILI D'AMBIENTE¶

SYSTEM

Se $SYSTEM è impostata, il suo valore avrà lo stesso effetto che fosse specificato come argomento dell'opzione -m.

MANPATH

Se $MANPATH è impostata, il suo valore è interpretato come una lista di percorsi di ricerca, separati da `:', di gerarchie di pagine di manuale da usare.

POSIXLY_CORRECT

Se $POSIXLY_CORRECT è impostata, anche ad un valore nullo, il metodo di ricerca predefinito di apropos sarà considerare la parola chiave come una espressione regolare estesa (-r) . Questo è ormai il comportamento predefinito.

FILE¶

/usr/share/man/index.(bt|db|dir|pag)

Un indice della cache della base di dati globale.

/var/cache/man/index.(bt|db|dir|pag)

Un indice alternativo e conforme con FHS.

/usr/share/man/.../whatis

Una tradizionale base di dati whatis.

VEDERE ANCHE¶

whatis(1), man(1).

AUTORI¶

Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).


Traduzione attuale di Giuseppe Sacco (eppesuig@debian.org)
Prima traduzione di Bortolozzo Giovanni (borto@pluto.linux.it)