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)

2.13.1                                             2025-05-02                                         APROPOS(1)