$£§@# de manuel

Publié le par Peck

Maintenant sur http://linux-attitude.fr/post/de-manuel

Niveau
:
Résumé: man 1 man

RTFM

Connaissez vous l'acronyme RTFM ? Il veut dire Read The Fucking Manual. C'est un mot couramment utilisé pour vous enjoindre poliment :-D de lire le manuel avant de poser des question stupides. On peut aussi trouver des variantes à base de google.

Pourquoi cette manie ? Tout simplement parce qu'on trouve tout dans le manuel ou presque. Il fut un temps ou les manuels étaient rares et on vous enjoignait plutôt de lire le source. Le code source d'une application est toujours la meilleure documentation qui soit car on peut vous certifier qu'elle est à jour :-)

Toujours est-il que le man est votre meilleur point d'entrée dans le monde unix, il permet entre autre de ne pas toujours solliciter vos amis lorsque vous pouvez vous débrouiller comme un grand.

Le premier man à connaître est évidemment man :
$ man man

Si vous voulez connaître la liste des manuels disponibles pour partir à la recherche d'une commande (et pour tous les lire bien sûr), vous pourrez les trouver dans /usr/share/man :
$ find /usr/share/man -type f

Chez moi cela ne renvoie que 10 000 fichiers, prenez votre temps.


Catégories

Pour vous repérer, les manuels sont divisés en 9 catégories :
1   Programmes exécutables ou commandes de l’interpréteur de  commandes (shell)
2   Appels système (Fonctions fournies par le noyau) ;
3   Appels  de  bibliothèque  (fonctions  fournies  par  les  bibliothèques des programmes)
4   Fichiers spéciaux (situés généralement dans /dev)
5   Formats des fichiers et conventions. Par exemple /etc/passwd
6   Jeux
7   Divers (y compris les macropaquets et les  conventions).   Par exemple, man(7), groff(7)
8   Commandes  de  gestion  du  système (généralement réservées au superutilisateur)
9   Sous-programmes du noyau [hors standard]

Il peut y avoir plusieurs pages de man avec le même nom si elles sont dans une catégorie différente. C'est pourquoi la catégorie est souvent indiquée entre parenthèses après le nom du man, ex : groff(7) qu'on appelle avec :
$ man 7 groff


Info

Un certain nombre de manuels sont maintenus sous un format légèrement différent du man. C'est en général indiqué en bas du manuel :
 The full documentation for ls is maintained as a Texinfo manual.

Il vous faut alors taper la commande info ls pour avoir une information probablement plus détaillée à propos de ls.
Attention, les raccourcis de info sont spéciaux, beaucoup ressemblent à ceux d'emacs. Les plus importantes sont ctrl-x ctrl-c pour quitter et ? pour obtenir de l'aide.


Amusons-nous

Sous debian le paquet funny-manpages installe des pages de manuel particulières. Par exemple :
$ man rtfm

Certaines entrant en conflit avec les man "normaux" on peut y accéder comme suit :
$ man -e fun date

Publié dans admin

Commenter cet article