apropos(s) Utility per le Pagine di Manuale apropos(s) NOME apropos - ricerca nei nomi e nelle descrizioni delle pagine di manuale SINTASSI apropos [-dhV] [-e|-w|-r] [-m sistema[,...]] [-M percorso] 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(a). Le regole di corrispondenza predefinite permettono la ricerca della corrispondenza nel nome della pagina ed in parole intere nella descrizione. OPZIONI -d, --debug Mostra informazioni utili al debug. -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 indipen- dentemente. Pu corrispondere ad una parte qualsiasi di entrambe. La corrispondenza non limitata a parole intere. -w, --wildcard Interpreta ogni parola chiave come un modello (pat- tern) contenente wildcard nello stile della shell. Di ogni parola chiave sar cercata la corrispondenza fra i nomi delle pagine e le descrizioni indipen- dentemente. trovata una corrispondenza solo se la parola chiave espansa corrisponde ad un'intera descrizione o nome di pagina. -e, --exact Di ogni parola chiave sar cercata la corrispondenza esatta tra i nomi delle pagine e le descrizioni. -m sistema[,...], --systems=sistema[,...] Se il sistema ha accesso alle descrizioni delle pagine di manuale di altri sistemi operativi, usando questa opzione pu essere fatta una ricerca anche in tali descrizioni. Per ricercare nelle descrizioni delle pagine di manuale di NewOS, usare l'opzione -m NewOS. Il sistema specificato pu essere una combinazione qualsiasi di nomi di sistemi operativi separati da virgole. Per includere una ricerca nelle descrizioni whatis del sistema operativo nativo, si includa il nome di sistema man nella stringa argo- mento. Usando questa opzione verr ignorata la variabile d'ambiente $SYSTEM. -M percorso, --manpath=percorso Specifica un'insieme di ricerca alternativo di ger- archie di percorsi di pagine di manuale separate da `:'. Di default, apropos usa la variabile d'ambi- ente $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 con- tenuto di $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 configu- razione. 2 Errore operativo. 16 Non stato trovato niente che corrisponde al crite- rio 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 espres- sione regolare estesa (-r) . Questo comunque il comportamento predefinito. 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 alterna- tiva e conforme con FHS. /usr/share/man/.../whatis Una tradizionale base di dati whatis. VEDERE ANCHE whatis(s), man(n). AUTORI Wilf. (G.Wilford@ee.surrey.ac.uk). Fabrizio Polacco (fpolacco@debian.org). Traduzione di Bortolozzo Giovanni (borto@pluto.linux.it) 2.3.20 07 September 2001 apropos(s)