Manpage

Pour les articles homonymes, voir man.

Capture d'écran de la page de manuel en anglais de la commande man

man est une commande disponible sur les systèmes d'exploitation de type Unix. Elle permet de visionner le manuel d'une commande d'un shell Unix.

Utilisation

Elle doit être utilisée sous la forme suivante :

man [-s<section>] <nom_de_commande>

Par exemple, pour voir le manuel de la commande ftp, il faut taper

$> man ftp

Pour naviguer dans une page, il faut généralement utiliser les flèches vers le haut et vers le bas ou les touches page down et page up, ou encore la touche d'espacement, selon le pager utilisé. On sort généralement d'une page avec la touche Q, mais, avec certaines versions, il faut appuyer sur la touche d'espacement jusqu'à ce qu'on arrive à la fin de la page de manuel.

Les pages du manuel Unix sont divisées en plusieurs sections. Par exemple, sous Linux, on retrouve les sections suivantes :

1. Commandes utilisateur
2. Appels système
3. Fonctions de bibliothèque
4. Fichiers spéciaux
5. Formats de fichier
6. Jeux
7. Divers
8. Administration système
9. Interface du noyau Linux

Chaque section possède une page d'introduction qui présente la section, disponible en tapant man <section> intro.

Les pages de manuel sont stockées dans les fichiers sources nroff. La plupart des versions de man cache les versions formatées des dernières pages affichées pour accélérer les prochains affichages.

Pour plus d'information sur man, il est possible de regarder la page man de man, avec la commande man man.

Historique

Le Manuel du programmeur UNIX (UNIX Programmer's Manual) a été publié le 3 novembre 1971. Cette première page de manuel a été écrite par Dennis Ritchie et Ken Dolotta sous les demandes répétés de Doug McIlroy. Les macros troff utilisées furent celles créés pour une utilisation générale par Ted Dolotta, ainsi que quelques ajouts pour les pages de manuel.

À l'époque, la disponibilité d'une documentation en ligne à l'aide des pages de manuel était considérée comme une avance importante. Depuis ce jour, virtuellement toutes les applications en ligne de commande pour Unix ont leur propre page de manuel. Beaucoup d'utilisateurs d'Unix ressentent le manque de page de manuel comme un signe de mauvaise qualité. En fait, certains projets, tel que Debian, écrivent leur propre pages de manuel pour les commandes qui en sont dépourvues.

Peu d'alternative à man ont eu le même succès, avec l'exception possible du projet GNU "info", un système simple et précurseur de hypertexte.

Cependant, le format d'une page unique par application, le manque de classification dans les sections, et les fonctionnalités relativement peu sophistiquées de mise en page, ont motivé le développement de systèmes de documentation alternatifs tels que le système info déjà mentionné.

La plupart des applications graphique pour UNIX (particulièrement celles construites pour les environnements GNOME et KDE) proposent maintenant de la documentation en HTML et incluent un outil pour lire ces pages directement dans l'application.

Les pages de manuel sont généralement disponibles en anglais. Des traductions dans d'autres langues sont disponibles pour certaines pages, quelquefois moins à jour que la version anglaise.

Le format par défaut des pages de manuel est troff, avec soit les macros man (orientés présentation), soit les macros mdoc (orientés sémantique). Ces formats rendent possible la conversion des pages de manuel dans d'autres formats comme HTML, PostScript, etc.

Voir également

• Commandes UNIX

Liens externes

Il existe plusieurs sites Web qui publient les pages man. En voici quelques-uns :

• (fr) Pages man de GNU Squad : Le plus grand dépôt de page de manuel en version web. Plus de 63 000 pages avec 15 langues disponibles.
• (fr) manpagesfr.free.fr : Version française des pages de manuel Linux du projet man-pages.
• (fr) www.delafond.org/traducmanfr : Toutes les autres pages de manuel Linux en version française.
• (fr) jp.barralis.com/howto/linux/Man-Page/Man-Page.php : Le HOWTO Linux sur les pages MAN en français

Commandes Unix
Aide	arch · apropos · cal · date · help · file · history · info · man · type · uname · whatis
Environnement utilisateur	env · dmesg · finger · halt · id · init · logname · mesg · passwd · reboot · shutdown · su · sudo · uptime · w · wall · who · whoami · write
Gestion de processus	at · bg · chroot · crontab · exit · fg · kill · lp · lpr · nice · pkill · ps · pstree · sleep · time · top
Manipulation de texte	awk · banner · bash · bc · cat · clear · cut · ed · head · join · nl · read · sed · sort · strings · tail · tee · tr · uniq · vi · vim · wc
Programmation shell	alias · basename · dirname · echo · expr · false · printf · test · true · unset
Recherche	egrep · fgrep · find · grep · locate · whereis · which · zegrep · zfgrep · zgrep
Réseau	ethtool · ftp · host · mail · mii-tool · nc · netstat · ping · ping6 · rlogin · ssh · sftp · telnet · traceroute
Système de Fichiers	cd · chgrp · chmod · chown · cp · dd · dir · du · df · file · gawk · less · ln · ls · lsof · mkdir · more · mount · mv · pwd · rm · rmdir · touch · umask · umount

• Portail de l’informatique