12. Come far funzionare correttamente `apropos' e `whatis'?

Supponiamo di voler sapere quali compilatori siano installati sul nostro sistema e come si possano utilizzare. Per rispondere a queste domande (poste frequentemente) si può digitare

funnyprompt$ apropos compiler
f77 (1) - Fortran 77 compiler 
gcc (1) - GNU C and C++ compiler
pc (1) - Pascal compiler

Apropos e whatis sono usati per fornire un breve resoconto su quali pagine di manuale contengono informazioni riguardo a un certo argomento. Entrambi i comandi effettuano una ricerca in numerosi file chiamati `whatis' che possono essere trovati in ognuna delle directory di base dei manuali. Come già precedentemente affermato, i file del database di whatis contengono una sola riga per ogni pagina di manuale presente nel rispettivo albero di directory. In effetti, questa riga è esattamente la sezione NOME (per esser precisi: il contenuto della sezione è riunito su una sola riga e privato della sillabazione; si noti che il numero di sezione è citato all'interno di parentesi). I file del database di whatis sono creati con il programma makewhatis(8). Poiché ne esistono svariate versioni, per verificare le opzioni disponibili è importante far riferimento alla pagina di manuale. Per far sì che makewhatis estragga correttamente le sezioni NOME, è importate che chi scrive il manuale si adegui al suo formato, descritto alla domanda 3. La differenza tra apropos e whatis sta semplicemente nel tipo di ricerca che fanno sulla riga. Apropos (che è equivalente a man -k) cerca la stringa ovunque posizionata sulla riga, mentre whatis (equivalente a man -f) prova a verificare la coincidenza della stringa con il nome completo del comando, posizionato nella parte che precede il trattino. Di conseguenza, `whatis cc' ci informerà se esiste un manuale relativo a cc e sarà reticente riguardo a gcc.

Correzioni e suggerimenti sono benvenuti!