Linux-Mandrake:
Guide de l'utilisateur
et Manuel de référence

MandrakeSoft

 
 
Janvier 2000
http://www.linux-mandrake.com


Suivant : Introduction à la ligne de commande
Précédent : Contrôle des processus
Retour

(Retour à la table des matières)

Chapitre 8 : Où obtenir de la documentation


Outre ce manuel et le manuel de référence, vous disposez de nombreuses sources de documentation, soit dans votre distribution même, soit sur l'Internet. Il en sera fait ici un inventaire aussi complet que possible.

La documentation fournie dans Linux-Mandrake

Les pages de manuel

C'est sans doute la source d'information principale au quotidien. Pratiquement toutes les commandes ont leur page de manuel, 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.

Les pages de manuel sont organisées en différentes sections, et il arrive que vous voyiez souvent dans des documents des références à « open(2) », « fstab(5) » ou autres, ce qui signifie respectivement la page de manuel d'open dans la section 2 et la page de manuel de fstab dans la section 5.

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 lui-même: man man. Les pages de manuel sont préformatées puis affichées avec un pager (« visionneuse »), qui est justement less par défaut. Vous savez donc déjà comment parcourir une page de manuel et la quitter :)

En haut de chaque page de manuel, vous pouvez voir le nom de la page de manuel et la section du manuel à laquelle cette page appartient; tout en bas de la page de manuel (en général dans la section VOIR AUSSI, ou SEE ALSO pour les pages de manuel non encore francisées) vous verrez des références à d'autres pages de manuel en relation avec celle que vous consultez.

Vous pouvez commencer par consulter les pages de manuel des différentes commandes qui ont été abordées dans ce manuel: man ls, man chmod, 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 tombez sur la page de manuel de la commande mknod) il vous faut expliciter la section: man 2 mknod 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.

Les pages info

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

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

Vous pouvez invoquer info de deux façons: soit sans aucun argument, auquel cas vous vous retrouverez au sommet de l'arborescence, soit suivi d'un nom de commande ou de paquetage, auquel cas 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, du texte tel que celui-ci:

* Buffers::

indique un lien. Si vous amenez 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:

Les commandes sont nombreuses, vous pouvez taper '?' pour en avoir une liste.

Les HOWTO

Les HOWTO (« comment faire ») sont des documents édités par le LDP (Linux Documentation Project, « projet de documentation pour Linux »), dédiés à la configuration de nombreux aspects de votre système. Ils existent dans de nombreuses langues et il est probable que le HOWTO dont vous avez besoin soit déjà traduit et présent sur votre disque dur, si tant est que vous ayez installé les paquetages correspondants (il s'agit des paquetages howto et howto-french pour les éditions anglaises et françaises respectivement). Ils se trouvent dans /usr/doc/HOWTO (ou /usr/doc/HOWTO/translations/fr). Leur forme initiale est celle de fichiers textes, mais ils sont aussi disponibles sous forme HTML pour consultation à partir d'un navigateur web, et PostScript pour l'impression.

La liste en est très longue: pour vous en convaincre, tapez ls /usr/doc/HOWTO/*-HOWTO | less. 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 trouviez la solution d'une part, mais aussi que vous appreniez beaucoup de choses en le lisant. Entre autres sujets sont couverts le réseau (NET-3-HOWTO), la configuration de cartes son (Sound-HOWTO), le gravage de CD (CD-Writing-HOWTO), la configuration de NIS et NFS, et bien d'autres choses encore.

Il faut cependant faire attention aux dates de dernière modification des HOWTO: certains n'ont pas été mis à jour depuis longtemps, et par conséquent il est probable que leur contenu ne soit plus d'actualité pour certains détails. Vérifiez donc bien la date d'édition, qui se trouve toujours au début du document, et méfiez-vous particulièrement des HOWTO liés à la configuration du matériel si ceux-ci sont anciens: c'est un domaine dans lequel Linux évolue très vite. Souvenez-vous aussi que le qualificatif « ancien » dans le mode du logiciel libre est encore plus significatif que dans l'informatique en général: un logiciel libre vieux de quinze jours est parfois considéré comme ancien.

Le répertoire /usr/doc

Quelques paquetages viennent également avec leur propre documentation, qu'ils auront placée dans un sous-répertoire de /usr/doc et dont le nom sera celui du paquetage. Le plus souvent, malheureusement, cette documentation est en anglais et n'est pas traduite.

L'Internet

Les sources d'informations sur Internet sont très nombreuses. Les sites web dédiés à Linux et à son utilisation ou sa configuration se comptent par centaines, voire par milliers. Mais il n'y a pas que les sites web.

Les sites web francophones dédiés à Linux

Parmi la multitude des sites web existants, voici quelques-uns des sites les plus complets:

Et bien sûr, n'oubliez pas votre moteur de recherche favori... C'est même l'outil le plus efficace: bien que les trois sites ci-dessus contiennent une grande quantité de documentations, il se peut que vous ne trouviez pas ce que vous cherchez. Quelques mots-clés bien choisis dans un moteur de recherche vous donnent souvent des liens vers des pages traitant de votre problème particulier.

Malheureusement pour ceux d'entre vous qui n'êtes pas anglophones, la documentation en anglais est beaucoup plus étoffée. En particulier, le site du LDP est en anglais, et son adresse est: http://metalab.unc.edu/LDP/.

Les forums de discussion

Pour obtenir de l'aide sur les news, vous pouvez (devez?) d'abord rechercher si votre problème n'a pas déjà été abordé (voire résolu) sur le site web Dejanews, à l'adresse suivante: http://www.deja.com/home_ps.shtml. Si vous ne trouvez rien, il existe un forum de discussions entièrement consacré à Linux-Mandrake (alt.os.linux.mandrake), et vous avez également à votre disposition deux groupes dans la « hiérarchie » des groupes de discussion fr.comp.os.linux.*:

Avant de poster dans l'un quelconque de ces groupes, assurez-vous d'avoir lu (ou digéré) le maximum de documentation que vous ayez pu trouver sur votre problème! Les personnes qui postent dans ces groupes et dont les habitués voient qu'elles n'ont lu aucune documentation le regrettent en général amèrement... car les premières réponses qu'on leur donne se résument à « lis la doc et reviens après ». Et surtout, surtout, ne posez aucune question concernant la configuration sur le groupe de discussion fr.comp.os.linux.debats! Ce n'est pas le sujet du groupe...

Partie II : Manuel de référence



Suivant : Introduction à la ligne de commande
Précédent : Contrôle des processus
Retour

Copyright © 2000 MandrakeSoft