Les manuels

Qu'est-ce que c'est ?

Les manuels Unix servent tout simplement à donner des explications sur les commandes Unix. On utilise les manuels sous systême Unix pour savoir comment utiliser une commande, mais aussi lorsque l'on programme, pour savoir comment utiliser une fonction C ou tk... Ce sont en fait des fichiers texte écris dans un langage particulier que l'on peut afficher à l'écran grâce à la commande man.

C'est très pratique car souvent très détaillé, mais ça a beaucoup d'inconvénients : il n'y a pas ou peu d'exemple, les explications sont très complètes mais souvent incompréhensibles pour les utilisateurs peu avertis et il n'y a pas d'outils simple de recherche dans les manuels.

Sur le disque, les fichiers des manuels sont stockés dans des sous-répertoires de /usr/man/ ou de /usr/local/man correspondants à leur section (man1, man2...). Il est donc toujours possible de trouver le manuel d'une commande en parcourant cette arborescence. Ce répertoire contient également un fichier whatis qui décrit brièvement tous les manuels Unix.

Utilisation des manuels

Pour consulter un manuel, rien de plus simple : il suffit de taper :

pour avoir des informations sur la commande foo.

Souvent, dans les manuels, on voit quelque chose de ce genre : crontab(5). Cela signifie qu'il faut se référer à la section 5 des manuels pour cette fonction. Il faut alors taper :

pour y accéder.

C'est presque parfait, mais il y a des subtilités : un manuel peut en cacher un autre. Il y a souvent plusieurs manuels répondant à la commande recherchée, et man va par défaut afficher le premier manuel trouvé. Par exemple, taper man crontab va afficher la section 1 de manuel pour crontab, alors que la section 5 du manuel pour cette fonction est beaucoup plus complète... Pour palier à ce problème, on peut utiliser l'option -a :

pour afficher successivement tous les sections de manuel en rapport avec crontab.

Ceci devrait suffir à démarrer avec les manuels. Pour plus d'informations sur la commande man, voir le manuel man(1) (faire man man).

Références

• man(1)
• liste complète des manuels Unix

 format imprimable