WHATIS(1) Utility per le Pagine di Manuale WHATIS(1)
NOME
whatis - mostra le descrizioni delle pagine di manuale
SINTASSI
whatis [-dhV] [-r|-w] [-m sistema[,...]] [-M percorso] nome ...
DESCRIZIONE
Ogni pagina di manuale ha disponibile al suo interno una breve
descrizione. whatis ricerca i nomi e le descrizioni delle pagine di
manuale che corrispondono a nome.
nome può contenere wildcard (caratteri jolly) (-w) o essere
un'espressione regolare (-r). 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).
Durante la ricerca sono usate le basi di dati index. Per generare
dalla base di dati index la corrispondente base di dati vecchio stile
whatis in formato testo, si può usare il comando:
whatis -M percorso_man -w '*' | sort > percorso_man/whatis
dove percorso_man è una gerarchia di pagine di manuale come ad esempio
/usr/man.
OPZIONI
-d, --debug
Mostra informazioni utili al debug.
-r, --regex
Interpreta ogni nome come un'espressione regolare. Verrà
trovata una corrispondenza se nome corrisponde ad una parte
qualsiasi del nome della pagina. Questa opzione fa sì che
whatis sia un po' più lento a causa della natura della ricerca
nella base di dati.
-w, --wildcard
Interpreta ogni nome come un modello contenente wildcard nello
stile della shell. Affinché ci sia una corrispondenza, un nome
espanso deve corrispondere al nome completo di una pagina di
manuale. Questa opzione fa sì che whatis sia un po' più lento a
causa della natura della ricerca nella base di dati.
-m sistema[,...], --systems=sistema[,...]
Se questo sistema ha accesso ai nomi delle pagine di manuale di
altri sistemi operativi, può essere fatto un accesso a
quest'ultimi usando questa opzione. Per effettuare una ricerca
nei nomi delle pagine di manuale di NewOS, usare l'opzione -m
NewOS.
Il sistema può essere una combinazione qualsiasi di nomi di
sistemi operativi separati da virgole. Per includere la ricerca
nei nomi delle 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.
-M percorso, --manpath=percorso
Specifica un insieme alternativo di gerarchie di pagine di
manuale, separate da `:', nelle quali fare la ricerca. Di
default, whatis usa la variabile d'ambiente $MANPATH finché
questa non è vuota o non impostata, nel qual caso determinerà un
percorso man appropriato basandosi sulla variabile d'ambiente
$PATH dell'utente. Usando questa opzione verrà ignorato il
contenuto della variabile d'ambiente $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 è stata trovata alcuna pagina di manuale che corrisponde al
criterio specificato.
VARIABILI D'AMBIENTE
SYSTEM Se $SYSTEM è impostata, avrà lo stesso effetto che fosse
specificata come argomento dell'opzione -m.
MANPATH
Se $MANPATH è impostata, il suo valore è interpretato come una
lista di percorsi, separati da `:', di gerarchie di pagine di
manuale da usare nella ricerca.
FILE
/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 FHS.
/usr/share/man/.../whatis
Una tradizionale base di dati whatis.
VEDERE ANCHE
apropos(1), man(1).
AUTORE
Wilf. (G.Wilford@ee.surrey.ac.uk).
Fabrizio Polacco (fpolacco@debian.org).
Traduzione di Giovanni Bortolozzo (borto@pluto.linux.it)
2.11.2 2023-01-08 WHATIS(1)
Generated by dwww version 1.15 on Mon Jul 1 05:04:37 CEST 2024.