Page suivante Page précédente Table des matières

12. Comment faire fonctionner les programmes 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.


Page suivante Page précédente Table des matières