debian-guide_fr-1.0_chap16.sgml
<chapt> Lire la documentation et obtenir de l'aide
<sect> Les sources de documentation
<p>
Sur un système Debian, vous pouvez trouver la documentation aux
emplacements suivants:
<p>
<list>
<item> Pages de manuel, que l'on peut lire avec la commande <prgn>man</prgn>
<item> Pages info, que l'on peut lire avec la commande <prgn>info</prgn>
<item> Les réprtoires de <prgn>/usr/doc/paquets</prgn> où
<em>paquet</em> est le nom du paquet
Debian<footnote><prgn>zless</prgn> est très pratique pour lire les
fichiers de <prgn>/usr/doc</prgn>. Voir chapitre 10.1 pour plus de
détails.</footnote>
<item> Le répertoire <prgn>/usr/doc/HOWTO</prgn> contient la
documentation sous forme de HOWTO du Projet Linux de Documentation, si
vous avez installé les paquets les contenant.
<item> La plupart des commandes ont une option <prgn>-h</prgn> ou
<prgn>--help</prgn>. Tapez le nom de la commande suivi d'une de ces
options pour essayer.
<item> Le Projet de Documentation de Debian
(<em>http://www.debian.org/~elphick/ddp/</em>) fournit aussi quelques
manuels.
<item> La page de support de Debian
(<em>http://www.debian.org/support/</em>) possède sa FAQ et quelques
autres documents. Vous pouvez aussi essayer le site oueb de Linux
(<em>http://www/linux.org</em>).
</list>
<p>
Cette apparente profusion de sources de documentations existe pour des
tas de raisons. Par exemple, <prgn>info</prgn> est supposé remplacer
le <prgn>man</prgn> mais <prgn>man</prgn> n'a toujours pas disparu à
ce jour. Mais dans tous les cas, il est rassurant de savoir que tant
de documentations existent !
<p>
Ainsi, où chercher pour obtenir de l'aide ? Voici quelques
suggestions:
<p>
<list>
<item> Utilisez la page info ou l'option <prgn>--help</prgn> pour
avoir un résumé rapide de la syntaxe et des options de la
commande. Utilisez aussi la page de manuel si le programme n'a pas de
page info.
<item> Utilisez la page info si le programme possède une documentation
à ce format.
<item> Si cela ne donne rien, allez voir dans
<prgn>/usr/doc/nomdepaquet</prgn>
<item> Utilisez les HOWTO pour régler une chose particulière ou une
information sur un matériel particulier. Par exemple,
l'<prgn>Eternet-HOWTO</prgn> regorge d'informations sur les cartes
Ethernet et le <prgn>PPP-HOWTO</prgn> explique en détail comment
configurer une liaison <prgn>ppp</prgn>.
<item> Utilisez les manuels du Projet de Documentation Debian pour les
concepts inhérents et spécifiques à Debian.
<item> Si tout cela ne donne rien, demandez de l'aide à
quelqu'un. Voir la partie 16.4 pour cela.
</list>
<p>
Comment utiliser les pages de manuel est expliqué à la partie 7.1. C'est très
simple: appuyez sur la touche espace pour aller à la page suivante et
appuyez sur <prgn>q</prgn> pour quitter le manuel. Utiliser
<prgn>info</prgn>, visualiser les fichiers de <prgn>/usr/doc</prgn> et
demander de l'aide à quelqu'un font l'objet des parties suivantes du
chapitre.
</sect>
<sect> Utiliser <prgn>info</prgn>
<p>
<prgn>info</prgn> est le visualiseur de documentation de GNU. Certains
programmes fournissent leur documentation au format <prgn>info</prgn>
et vous pouvez utiliser <prgn>info</prgn> pour la lire. Vous pouvez
lancer le visualiseur en tapant simplement <prgn>info</prgn> ou en lui
passant un argument comme ceci:
<p>
<example>
info emacs
</example>
<p>
Vous pouvez aussi faire appel à l'information sur <prgn>info</prgn>
lui-même en appelant le tutoriel interne:
<p>
<example>
info info
</example>
<p>
Maintenant, vous pouvez vous déplacer à l'aide des touches suivantes:
<p>
<list>
<item> <prgn>flèches</prgn>
<p>
Pour déplacer le curseur au sein du document.
<item> <prgn>m RET</prgn>
<p>
Sélectionne le choix d'un menu sous le curseur.
<item> <prgn>u</prgn>
<p>
Pour « remonter » dans le document.
<item> <prgn>n</prgn>
<p>
Pour aller à la page suivante.
<item> <prgn>p</prgn>
<p>
Pour aller à la page précédente.
<item> <prgn>s</prgn>
<p>
Pour rechercher quelque chose.
<item> <prgn>g</prgn>
<p>
Pour aller à une page spécifique.
<item> <prgn>q</prgn>
<p>
Quitter <prgn>info</prgn>
</list>
<p>
Vous remarquerez que la ligne supérieure de l'écran indique les pages
<em>next</em> (suivantes), <em>previous</em> (précédentes) et
<em>up</em> (supérieures) qui correspondent aux actions des touches
<prgn>n</prgn>, <prgn>p</prgn> et <prgn>u</prgn>.
</sect>
<sect> HOWTO
<p>
En plus de leurs livres, le Projet de Documentation Linux a écrit une
série de petits documents décrivant comment configurer des aspects
particuliers de GNU/Linux. Par exemple, le SCSI-HOWTO décrit les
complications de l'utilisation du SCSI - une façon standard de
communiquer avec des périphériques - sous GNU/Linux. De façon
générale, les HOWTO ont plus de détails techniques sur des
configurations matérielles et sont souvent plus à jour que ce manuel.
<p>
Il y a des paquets Debian pour les HOWTO. <prgn>doc-linux-text</prgn>
contient l'ensemble des HOWTO au format texte et
<prgn>doc-linux-html</prgn> les contient (surprise!) au format html
pour naviguer. Remarquez bien que Debian fournit des traductions de
ces HOWTO si l'anglais n'est pas votre langue maternelle. Debian a des
paquets en allemand, français, espagnol, italien, japonais, coréen,
polonais, suédois et chinois des HOWTO. On les trouve généralement
dans les paquets <prgn>doc-linux-<em>languagecode</em></prgn> où
<em>languagecode</em> est <prgn>fr</prgn> pour le français,
<prgn>es</prgn> pour l'espagnol, etc... Si vous les avez installés,
vous les trouverez dans <prgn>/usr/doc/HOWTO</prgn>. Quoi qu'il en
soit, vous trouverez toujours les toutes dernières versions sur le
réseau sur la page du LDP:
<p>
<example>
http://metalab.unc.edu/LDP/
</example>
<sect> Aide personnalisée
<p>
L'emplacement correct<footnote>Les francophones ont leur propre liste
avec l'avantage du support de leur langue maternelle:
debian-french@lists.debian.org</footnote> pour demander de l'aide sur
Debian est la liste de distribution des utilisateurs de Debian à
<prgn>debian-user@list.debian.org</prgn> (envoyer un courriel à
<prgn>debian-user@list.debian.org</prgn>). Si vous savez vous servir
d'IRC, vous pouvez utiliser le canal <prgn>#debian</prgn> sur
<prgn>irc.debian.org</prgn>. Vous pouvez trouver de l'aide sur
GNU/Linux en général dans la hiérarchie USENET
<prgn>comp.os.linux.*.</prgn> Il est aussi possible d'embaucher des
consultants pour fournir un service de support garantie. Le site oueb
de Debian (<em> http://www.debian.org</em>) fournit d'autres
informations sur beaucoup de ces ressources.
<p>
Une nouvelle fois, ne contactez pas les auteurs (et le traducteur!) de
ce livre pour obtenir de l'aide. Nous ne serons de toute façon
certainement pas capable de répondre à votre problème spécifique. Si
vous vous adressez à <prgn>debian-user</prgn>, vous recevrez quantité
de messages de qualité, et qui plus est rapidement.
<p>
Restez toujours courtois et faîtes un effort vous-même en lisant la
documentation. Rappelez-vous bien que Debian résulte d'un effort
collectif de volontaires et que les personnes vous font une faveur en
vous donnant un peu de leur temps pour vous aider. Beaucoup d'entre
eux font payer ce même service plusieurs centaines de dollars pendant
la journée.
<p>
<em> Ce qu'il faut faire pour poser des questions </em>
<p>
<list>
<item> Lire la documentation évidente en premier. Les trucs comme les
options des commandes et ce que fait une commande en fait partie. Cela
inclut aussi les pages de manuel et la documentation au format info.
<item> Vérifier les documents HOWTO si votre question concerne un
réglage comme une connexion <prgn>ppp</prgn> ou <prgn>Ethernet</prgn>.
<item> Essayez d'être sûr que la réponse ne se trouve pas dans ce
livre.
<item> N'ayez pas peur de demander, après avoir fait l'effort
d'essayer de comprendre.
<item> N'ayez pas peur de demander des explications conceptuelles, des
conseils et en général sur tous les aspects que l'on ne trouve pas
dans les documentations.
<item> Joignez toute information intéressante. Vous devez toujours
mentionner la version de Debian que vous utilisez. Vous pouvez aussi
mentionner le numéro de version de tout paquet pertinent. La commande
<prgn>dpkg -l nomdupaquet </prgn> vous le fournit. Vous pouvez aussi
signaler ce que vous avez tenté et ce qu'il est advenu. N'oublier
d'inclure les messages d'erreur complets et exacts, s'il y en a.
<item> Ne vous excusez pas d'être un nouveau sur Linux. Il n'y a pas
de raison d'être un expert pour pouvoir utiliser GNU/Linux, pas plus
qu'il est nécessaire d'être une mécanique pour conduire une
automobile.
<item> Ne postez pas ou n'envoyez pas de courriel en HTML. Certaines
versions de Netscape ou d'Internet Explorer postent par défaut en HTML
plutôt qu'en texte. Beaucoup de gens vont carrément alors ignorer ces
courriels car de nombreux lecteurs de courriels ont des difficultés à
lire ce format. Il y a une préférence quelque part pour désactiver le
support HTML.
<item> Soyez courtois. Rappelez-vous que Debian est un effort
collectif de bénévoles et quiconque vous aide vous donne une partie de
son temps libre.
<item> Renvoyez votre question à la liste si vous n'avez pas eu de
réponse après quelques jours. Il y avait peut-être de nombreux
messages et il est passé inaperçu. Ou peut-être que personne ne
connaissait la réponse et si personne n'est capable de répondre la
fois suivante, il s'agit d'une sacrée colle. Vous pourrez peut-être
fournir plus d'informations la fois suivante.
</list>
</sect>
<sect> Extraire des informations du système
<p>
Lorsque vous diagnostiquez un problème ou lorsque vous demandez de
l'aide, vous aurez besoin d'extraire des informations de votre
système. Voici quelques façons d'y parvenir:
<p>
<list>
<item> Examinez les fichiers placés dans <prgn>/var/log</prgn>
<item> Examinez la sortie du message de la commande <prgn>dmesg</prgn>
<item> Lancez la commande <prgn>uname -a</prgn>
</list>
</sect>
</chapt>
--
|\ _,,,---,,_ Patrice KARATCHENTZEFF
ZZZzz /,`.-'`' -. ;-;;,_ mailto:pkarat@club-internet.fr
|,4- ) )-,_. ,\ ( `'-' p.karatchentzeff@free.fr
'---''(_/--' `-'\_)
Reply to: