apropos
et whatis
? Supposons que vous recherchiez les compilateurs installés sur votre système et comment les invoquer (nous considérons le cas courant, où tout le manuel est en langue anglaise). Pour répondre à cette question (fréquemment posée), il faut faire :
$ apropos compiler
f77 (1) - Fortran 77 compiler
gcc (1) - GNU C and C++ compiler
pc (1) - Pascal compiler
apropos
et whatis
sont utilisées pour
obtenir une réponse rapide sur les pages de manuels qui
contiennent des informations sur un certain sujet. Les deux
programmes cherchent dans des fichiers nommés
whatis qui sont dans chaque
répertoire de base du manuel. Comme je l'ai déjà dit, les
fichiers de la base de données whatis contiennent une
entrée d'une ligne pour chaque page de manuel dans
l'arborescence des répertoires successifs. En fait, cette
ligne est exactement celle de la section NAME (pour être
précis : tout est réduit à une seule ligne et le tiret
est supprimé, la section étant placée entre parenthèses). Ces
fichiers sont créés à l'aide du programme
makewhatis(8)
. Il en existe plusieurs versions, donc
référez-vous à la page de manuel du programme pour connaître
les options possibles. Afin que makefile
puisse
extraire les sections NAME correctement, il est important que
vous, le rédacteur du manuel, respectiez le format de cette
section décrit dans la partie 2. La différence entre
apropos
et whatis
est ce qu'ils recherchent et où.
apropos
(qui est l'équivalent de man -k
)
cherche la chaîne de caractères qui lui est passée en argument
n'importe où dans la ligne alors que whatis
(équivalent de man -f
) recherche dans la
partie avant le tiret un nom de commande complet. Par
conséquence, whatis
dira s'il y a un manuel de
cc
mais restera muet pour gcc
.