2. Ressources GNU/Linux

Résumé

Dans cette section, nous présenterons des ressources utiles pour toute distribution GNU/Linux. La plupart ne sont pas écrites spécialement pour Mandriva Linux, mais sont tout de même très utiles.

2.1. Le répertoire /usr/share/doc

La plupart des paquetages incluent également leur propre documentation, dans un sous-répertoire de /usr/share/doc et leur nom est souvent celui du paquetage. Malheureusement, cette documentation est souvent en anglais. La documentation de la distribution Mandriva Linux est elle-même disponible depuis le répertoire /usr/share/doc/mandriva/.

2.2. Les pages de manuel

Résumé

Les pages « man » sont principalement dédiées aux commandes et aux applications en ligne de commande de GNU/Linux. Les commandes utilisées à travers la console ont un rayon d'action très étendu sur le système (voir le chapitre Introduction à la ligne de commande du Manuel de référence). Si ces pages semblent un peu rébarbatives au premier abord, elles offrent tous les détails nécessaires et il est recommandé de les consulter dès qu'un problème spécifique à une commande survient.

Les pages man sont sans doute la source d'information principale pour les commandes shell. Pratiquement toutes les commandes ont leur page de manuel (man page) et il y en a aussi sur le format de certains fichiers de configuration, sur les fonctions de bibliothèques de programmation, etc. Une grande partie des pages de manuel existent en français.

Le contenu des pages de manuel est organisé en différentes sections. Les références à ces sections sont faites de la manière suivante : open(2), fstab(5) se réfèrent respectivement à la page de manuel de open dans la section 2, et à la page de manuel de fstab dans la section 5.

[Astuce]Astuce

La manière la plus simple de consulter une page de manuel est d'utiliser un navigateur. Dans Konqueror, tapez man:/man(1) dans le champ URL et la page de man pour la commande man s'affichera. Par exemple, pour afficher la page man de fstab(5), il suffit de taper dans le champ URL : man:/fstab(5)

La commande pour afficher une page de manuel dans un terminal (appelé aussi shell) est man et sa syntaxe est la suivante :

man [options] [section] <page de manuel>

man possède sa propre documentation, accessible en tapant man man. Les pages de manuel sont préformatées puis affichées avec un pager (un afficheur page par page), less en l'occurrence.

Les noms des pages de manuel et de leurs sections respectives apparaissent en haut de chacune des pages. Tout à fait au bas de ces dernières (en général dans la section VOIR AUSSI ou SEE ALSO pour les pages de manuel qui ne sont pas encore francisées) se trouvent des références vers d'autres pages de manuel qui traitent de sujets connexes.

Vous pouvez commencer par consulter les pages de manuel des différentes commandes abordées dans le Manuel de référence : ls(1), chmod(1), etc.

Si vous ne tombez pas sur la bonne page de manuel — par exemple, vous voulez utiliser la fonction mknod dans un de vos programmes, mais ouvrez la page de manuel de la commande mknod —, vous devez mentionner la section : en l'occurrence, man 2 mknod. Si vous ne vous souvenez plus de la section exacte, la commande man -a mknod parcourra toutes les sections à la recherche de pages de manuel ayant pour nom mknod.