Linux Attitude

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( Use the Source Luke !). 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 seul 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), il existe bien sûr une commande man pour cela :

$ man -k ".*"

En pratique certains de ces manuels sont identiques, car ce sont des liens symboliques. Mais tout de même :

$ find /usr/share/man -type f

ne renvoie que 10 000 fichiers chez moi, 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

Il existe aussi des sous catégories, par exemple 3perl, qui utilisent une catégorie mais évitent de polluer l'espace de nom (cela se fait beaucoup pour les langage de programmation).

Enfin, si vous voulez lire le manuel dans une langue différente (par exemple l'original en anglais) :

$ LANG=C man ls

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