Linux-Mandrake: |
Guide de l'utilisateur |
et Manuel de référence |
MandrakeSoft
Janvier 2000 http://www.linux-mandrake.com
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.
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 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:
'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 avoir
une liste.
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.
/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.
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.
Parmi la multitude des sites web existants, voici quelques-uns des sites les plus complets:
http://www.linux-france.org/article/
: site web de
documentations, pour la plupart originales;
http://www.freenix.org/unix/linux/
: d'autres documentations;
http://uhp.u-nancy.fr/linux/
: toujours des documentations
:)
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/
.
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.*
:
fr.comp.os.linux.configuration
: questions sur la
configuration de Linux (périphériques, configuration
d'applications) et résolution de problèmes divers;
fr.comp.os.linux.moderated
: questions relatives à
l'utilisation et à la configuration de Linux, groupe
« modéré » (assez haut niveau).
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...