Chapitre 8. Où obtenir de la documentation

Table des matières
8.1. La documentation fournie avec Mandrake Linux
8.1.1. Les pages de manuel
8.1.2. Les pages info
8.1.3. Les HOWTOs
8.1.4. Le répertoire /usr/doc
8.2. Internet
8.2.1. Les sites Internet dédiés à GNU/Linux
8.2.2. Listes de diffusion (Mailing Lists)
8.2.3. Les forums de discussion
8.3. Comment résoudre un problème sous Mandrake Linux
8.3.1. RTFM
8.3.2. Chercher sur Internet
8.3.3. Archives de listes de diffusion et de forums
8.3.4. Questions aux listes de diffusion et forums
8.3.5. Contacter directement la personne responsable du projet
8.3.6. Services professionnels Mandrake
8.3.7. Formation

Outre ce manuel et le manuel de référence, vous disposez de nombreuses sources de documentation, soit à même votre distribution, soit sur Internet. Dans ce chapitre, vous trouverez un inventaire aussi complet que possible des sources à consulter en cas de besoin.

8.1. La documentation fournie avec Mandrake Linux

8.1.1. Les pages de manuel

C'est sans doute la source d'information principale au quotidien. Pratiquement toutes les commandes ont leur page de manuel (man page, mais il y a aussi des pages de manuel sur le format de certains fichiers de configuration, sur les fonctions de bibliothèques (en anglais, library) pour les programmeurs, et d'autres encore. Une grande partie des pages de manuel existent en français, mais malheureusement pas toutes.

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

La commande pour afficher une page de manuel est man, et sa syntaxe est la suivante :
man [options] [section] <page de manuel>
Il y a même une page de manuel pour man, soit man man. Elles sont préformatées puis affichées avec un pager (ou visionneuse)  less est utilisée par défaut. Donc, vous savez déjà comment parcourir une page de manuel et la quitter :-)

Les noms des pages de manuel et de leurs sections relatives apparaissent au haut de chacune des pages. En bas de ces pages (en général dans la section VOIR AUSSI ou SEE ALSO pour les pages de manuel qui ne sont pas encore francisées) pointent vers d'autres pages de manuel, et traitent de sujets connexes à ceux de la page que vous consultez.

Vous pouvez commencer par consulter les pages de manuel des différentes commandes qui ont été abordées dans ce manuel : 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 sur la page de manuel de la commande mknod, il vous faut expliciter la section : mknod(2) en l'occurrence, ou si vous ne vous souvenez plus de la section exacte, man -a mknod, qui parcourra toutes les sections à la recherche de pages de manuel ayant pour nom mknod.

8.1.2. Les pages info

Les pages info sont une autre source de documentation, plus complète que les pages de manuel. La commande pour les consulter est info.

Elles sont organisées sous forme d'arborescence dont le sommet s'appelle dir. À partir de là, vous pouvez accéder à toutes les pages info existantes.

Vous pouvez accéder aux pages info de deux façons : soit sans aucun argument. Ainsi, vous vous retrouverez au sommet de l'arborescence. Si vous y rajoutez un nom de commande ou de paquetage, la page correspondante, si elle existe, sera ouverte. Par exemple :

info emacs

Malheureusement toutes les pages d'info sont pour l'instant en anglais. Dans les pages info, un texte similaire à :
* Buffers::
indique un lien. Si vous placez le curseur sur ce lien (à l'aide des touches fléchées) et appuyez sur la touche Entrée, vous serez alors amené à la page info correspondante.

Les raccourcis clavier suivants existent :

  • u : pour Up (haut), monte au niveau supérieur ;

  • n : pour Next (prochain), va à la page info suivante dans ce niveau de l'arborescence ;

  • p : pour Prev (précédent), va à la page info précédente.

Les commandes sont nombreuses, vous pouvez taper ? pour en obtenir la liste.

8.1.3. Les HOWTOs

Les HOWTO (ou « comment faire  ») sont édités par le LDP (Linux Documentation Project, projet de documentation Linux) et sont dédiés à la configuration de nombreux aspects de votre système. Si le bon paquetage est installé (il s'agit des paquetages howto-html-en et howto-html-fr pour les éditions anglaise et française respectivement), ils sont disponibles dans de nombreuses langues et procurent des réponses ou solutions spécifiques à des problèmes reliés à votre système. Cette documentation se trouve dans le répertoire /usr/doc/HOWTO/HTML/fr/ pour la version française. Leur forme initiale est celle de fichiers textes, mais vous pouvez également les visualiser dans un navigateur Web en format HTML. Vous pouvez aussi les imprimer en format PostScript.

La liste est très longue : pour vous en convaincre, consultez l'index à partir du menu principal de votre gestionnaire de fenêtres : Documentation->Howtos French. Si vous tombez sur un problème que vous n'arrivez pas à résoudre, trouver le HOWTO correspondant s'il existe ; le lire est le meilleur point de départ, et il est très probable que vous y trouverez la solution d'une part. Aussi, vous apprendrez beaucoup de choses en le lisant. Entre autres sujets sont couverts le réseau (NET-3-HOWTO), la configuration de cartes son (Sound-HOWTO), comment graver un CD (CD-Writing-HOWTO), la configuration de NIS et NFS, ainsi que plusieurs autres sujets.

Il faut cependant faire attention aux dates de dernière modification des HOWTOs : certains n'ont pas été mis à jour depuis des lustres. Conséquemment, il est probable que leur contenu ne soit plus valide. Donc, méfiez-vous des vieux HOWTOs traitant particulièrement de configuration matérielle puisque GNU/Linux évolue très vite. Souvenez-vous aussi que le qualificatif « ancien  » dans le mode du logiciel libre est encore plus significatif qu'en informatique en général : un logiciel libre vieux de quinze jours est parfois considéré comme ancien, voire périmé !

Note

Les HOWTOs sont disponibles en ligne sur le site du LDP et susceptibles d'y être légèrement plus à jour. Consultez aussi les HOWTOs : (classés par catégorie) ; et FAQs.

8.1.4. Le répertoire /usr/doc

Quelques paquetages viennent également avec leur propre documentation, Ils sont placée dans un sous-répertoire de /usr/doc et leur nom est souvent celui du paquetage. Malheureusement, cette documentation est souvent en anglais et n'est pas traduite.


Tux sur Étoile de MandrakeSoft Linux est une marque déposée de Linus Torvalds. Toutes les autres marques et copyrights sont la propriété de leurs auteurs respectifs.
Sauf mention contraire, tout le contenu de ces pages et toutes les images sont Copyright MandrakeSoft S.A. et MandrakeSoft Inc. 2002.
http://www.mandrakelinux.com/