Les pages du User Manual Unix, plus connues sous le nom « pages man », sont une collection de documents informatiques mis à disposition des utilisateurs.

C'est le premier outil de documentation de tout utilisateur.

Origine et objectifs

Le manuel de l'utilisateur est un document qui a été créé et « standardisé » en même temps que les premiers systèmes unix. Son objectif est de documenter plusieurs aspects du système, en allant des commandes utilisateurs à un glossaire de certains termes utilisés en informatique.

Durant toute l'histoire d'unix, les pages du manuel ont toujours été distribuées avec chaque système, chaque éditeur personnalisant les pages en fonction des spécificicités de sa version.

C'est pourquoi on retrouvera à peu près toujours les mêmes « pages man » quelque soit le système unix, mais où la manière de documenter et les options de chaque programme change d'une version à l'autre.

Sections

Le manuel décrit plusieurs aspects du système. De fait, il est composé de plusieurs sections, chacune décrivant un aspect différent. Les sections standardisées (disponibles partout) sont :

1. les commandes utilisateur (User Commands)
2. les appels système (System Calls)
3. les fonctions des bibliothèques installées (Library Functions)
4. les fichiers spéciaux et périphériques (Special Files)
5. les formats de fichier (File Formats)
6. les jeux (Games)
7. divers (Miscellaneous)
8. commandes administrateur (Administration and Priviledged Commands)
9. documentation du noyau (Kernel Reference Guide)

Il existe des noms de page documentés dans plusieurs sections à la fois. Par exemple, « printf » est documenté à la fois dans la section 1 et la section 3. Pour les distinguer, il est d'usage de donner le numéro de section auquel on fait allusion entre parenthèses, en suffixe au nom de la page. Par exemple : man(1), printf(3), X(7), ascii(5).

Accès

La manière la plus simple et la plus connue d'accéder au manuel est d'utiliser la commande man, en lui donnant le nom de la page à consulter en argument.

man recherche la page demandée dans le manuel et affiche la première page trouvée. De ce fait, on peut indiquer à man la section dans laquelle on veut restreindre la recherche. Par exemple:

  man printf
  => accès à 'printf' dans la section 1

  man 3 printf
  => accès à 'printf' dans la section 3

Par ailleurs, on peut faire une recherche par contenu, pour trouver toutes les pages man qui font allusion à un certain sujet. Pour cela, on utilise l'option « -k » de la commande man, ou la commande « apropos ». Les deux sont équivalents:

  man -k printf
  apropos printf

Et bien sûr, ne pas oublier la commande « man man » !