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[,...]
              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
              argomento.  Usando questa opzione verrà ignorata la variabile d'ambiente $SYSTEM.

       -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)