<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>La documentation fournie avec Mandrakelinux</title><meta name="generator" content="DocBook XSL Stylesheets V1.64.0"><link rel="home" href="index.html" title="Guide de démarrage"><link rel="up" href="get-doc-chapter.html" title="Chapitre 6. Où obtenir de la documentation"><link rel="previous" href="get-doc-chapter.html" title="Chapitre 6. Où obtenir de la documentation"><link rel="next" href="ch06s02.html" title="Comment résoudre un problème sous Mandrakelinux"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">La documentation fournie avec Mandrakelinux</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="get-doc-chapter.html">Précédent</a> </td><th width="60%" align="center">Chapitre 6. Où obtenir de la documentation</th><td width="20%" align="right"> <a accesskey="n" href="ch06s02.html">Suivant</a></td></tr></table><hr></div><div class="sect1" lang="fr"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2544115"></a>La documentation fournie avec Mandrakelinux</h2></div></div><div></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="id2544128"></a>La documentation de Mandrakesoft</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa2"></a>Cette section détaille la documentation produite par <span class="application">Mandrakesoft</span> pour la version en cours :</p><div class="itemizedlist"><ul type="disc"><li><p><a name="BId-get-doc-chapter-pa3"></a>Vous pouvez également consulter les versions remises à jour en ligne : <a href="http://www.mandrakelinux.com/fr/fdoc.php3" target="_top">les pages documentation de Mandrakelinux</a>. </p><p><a name="BId-get-doc-chapter-pa4"></a>Si vous avez choisi le groupe de documentation durant l'installation, vous trouverez tous nos guides dans les langues que vous avez installées dans la section <span class="guimenu">D'autres applications</span>+<span class="guimenu">Documentation</span> du menu principal.</p></li><li><p><a name="BId-get-doc-chapter-pa7"></a><i class="citetitle">Guide de démarrage</i>;</p><p><a name="BId-get-doc-chapter-pa8"></a>Ce manuel a pour but de guider vos premiers pas avec <span class="application">Mandrakelinux</span>. Il traite de sujets basiques qui intéresseront les nouveaux utilisateurs <span class="application">GNU/Linux</span>, et de configuration plus avancée concernant des situations courantes.</p></li><li><p><a name="BId-get-doc-chapter-pa9"></a><i class="citetitle">Manuel de référence</i>;</p><p><a name="BId-get-doc-chapter-pa10"></a>Disponible en ligne et dans l'édition <span class="productname">Mandrakelinux - Édition PowerPack</span>™ de <span class="application">Mandrakelinux</span>, ce document aborde les fonctions avancées de <span class="application">GNU/Linux</span> et l'administration du système.</p></li><li><p><a name="BIdNEW-get-doc-chapter-pa70"></a><i class="citetitle">Guide d'administration serveur</i>;</p><p><a name="BIdNEW-get-doc-chapter-pa71"></a>Cette partie couvre les services disponibles sous Linux les plus populaires comme <span class="acronym">HTTP</span>, <span class="acronym">FTP</span>, <span class="acronym">POP</span>, et <span class="acronym">SMTP</span>. Ce document n'est disponible qu'en ligne ou sur <span class="acronym">CD</span>. </p></li></ul></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="id2544376"></a>Les pages de manuel</h3></div></div><div></div></div><a class="indexterm" name="BIdNEW-get-doc-chapter-it4"></a><a class="indexterm" name="BIdNEW-get-doc-chapter-it5"></a><p><a name="BId-get-doc-chapter-pa11"></a>C'est sans doute la source d'information principale au quotidien. Pratiquement toutes les commandes ont leur page de manuel (<span class="foreignphrase"><i class="foreignphrase">man page</i></span>), et il y a aussi des pages de manuel sur le format de certains fichiers de configuration, sur les fonctions de bibliothèque (en anglais, <span class="foreignphrase"><i class="foreignphrase">library</i></span>) pour les programmeurs, etc. Une grande partie des pages de manuel existent en français, mais malheureusement, elles ne sont pas traduites.</p><p><a name="BId-get-doc-chapter-pa12"></a>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 : <span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt1"></a>open</span>(2)</span>, <span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt2"></a>fstab</span>(5)</span> se réfèrent respectivement à la section 2 de la page de manuel <span><b class="command">open</b></span> et à la section 5 de la page de manuel <span><b class="command">fstab</b></span>. </p><p><a name="BId-get-doc-chapter-pa13"></a>La commande pour afficher une page de manuel dans un terminal (ou <span class="foreignphrase"><i class="foreignphrase">shell</i></span>) est <span><b class="command">man</b></span>, et sa syntaxe est la suivante : <a name="BId-get-doc-chapter-sc1"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">man [options] [section] <page de manuel></pre></td></tr></table><p> Il y a même une page de manuel pour <span><b class="command">man</b></span>, soit <span><b class="command">man man</b></span>. Elles sont pré-formatées puis affichées avec un <i class="glossterm"><a name="BId-get-doc-chapter-gt1"></a> <span class="foreignphrase"><i class="foreignphrase">pager</i></span></i> (ou visionneuse), <span><b class="command">less</b></span> étant utilisé par défaut.</p><p><a name="BId-get-doc-chapter-pa14"></a>Les noms des pages de manuel et de leurs sections relatives apparaissent en haut de chacune des pages. Tout à fait au bas de ces dernières (en général dans la section <span class="emphasis"><em>VOIR AUSSI</em></span> ou <span class="foreignphrase"><i class="foreignphrase">SEE ALSO</i></span> pour les pages de manuel qui ne sont pas encore francisées) d'autres pages de manuel sont mentionnées, et traitent de sujets connexes à ceux de la page que vous consultez.</p><p><a name="BId-get-doc-chapter-pa15"></a>Vous pouvez commencer par consulter les pages de manuel des différentes commandes qui sont abordées dans le <i class="citetitle">Manuel de référence</i> : <span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt3"></a>ls</span>(1)</span>, <span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt4"></a>chmod</span>(1)</span>, etc.</p><p><a name="BId-get-doc-chapter-pa16"></a>Si vous ne tombez pas sur la bonne page de manuel –– par exemple, vous voulez utiliser la fonction <tt class="literal">mknod</tt> dans un de vos programmes mais ouvrez la page de manuel de la commande <span><b class="command">mknod</b></span> ––, vous devez mentionner la section : en l'occurrence, <span class="citerefentry"><span class="refentrytitle"><a name="BId-get-doc-chapter-rt5"></a>mknod</span>(2)</span>. Si vous ne vous souvenez plus de la section exacte, la commande <span><b class="command">man -a mknod</b></span> parcourra toutes les sections à la recherche de pages de manuel ayant pour nom <tt class="literal">mknod</tt>. </p></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="id2544723"></a>Les pages info</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa17"></a>Elles sont une autre source de documentation, plus complète que les pages de manuel. La commande pour les consulter depuis un terminal est <span><b class="command">info</b></span>.</p><p><a name="BId-get-doc-chapter-pa18"></a>Elles sont organisées sous forme d'arborescence dont le sommet s'appelle <tt class="filename">dir</tt>. À partir de là, vous pouvez accéder à toutes les pages <span><b class="command">info</b></span> existantes.</p><p><a name="BId-get-doc-chapter-pa19"></a>Vous pouvez accéder aux pages <span><b class="command">info</b></span> de deux façons. Sans argument, 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 : <a name="BId-get-doc-chapter-pl1"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="programlisting">info emacs</pre></td></tr></table><p> Malheureusement, toutes les pages d'<span><b class="command">info</b></span> sont pour l'instant en anglais. Dans les pages <span><b class="command">info</b></span>, un texte similaire à : <a name="BId-get-doc-chapter-sc2"></a></p><table border="0" bgcolor="#E0E0E0"><tr><td><pre class="screen">* Buffers::</pre></td></tr></table><p> indique un lien. Si vous placez le curseur sur ce lien (à l'aide des touches fléchées) et appuyez sur la touche <b class="userinput"><tt>Entrée</tt></b>, vous serez alors amené à la page <span><b class="command">info</b></span> correspondante.</p><p><a name="BId-get-doc-chapter-pa20"></a>Les raccourcis-clavier suivants existent :</p><div class="itemizedlist"><ul type="disc"><li><p><a name="BId-get-doc-chapter-pa21"></a><span><b class="keycap">u</b></span> : pour <span class="foreignphrase"><i class="foreignphrase">Up</i></span> (haut), monte au niveau supérieur ;</p></li><li><p><a name="BId-get-doc-chapter-pa22"></a><span><b class="keycap">n</b></span> : pour <span class="foreignphrase"><i class="foreignphrase">Next</i></span> (prochain), va à la page <span><b class="command">info</b></span> suivante dans ce niveau de l'arborescence ;</p></li><li><p><a name="BId-get-doc-chapter-pa23"></a><span><b class="keycap">p</b></span> : pour <span class="foreignphrase"><i class="foreignphrase">Prev</i></span> (précédent), va à la page <span><b class="command">info</b></span> précédente.</p></li><li><p><a name="get-doc-chapter-pa27a"></a><span><b class="keycap">q</b></span> : pour <span class="foreignphrase"><i class="foreignphrase">Quitter</i></span>, ferme la visionneuse <span><b class="command">info</b></span>.</p></li></ul></div><p><a name="BId-get-doc-chapter-pa24"></a>Les commandes sont nombreuses, vous pouvez taper « <span class="quote">?</span> » pour en obtenir la liste.</p></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="id2544983"></a>Les HOWTO</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa25"></a>Les <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> (ou « <span class="quote">comment faire</span> ») sont édités par le <span class="acronym">TLDP</span> (<span class="foreignphrase"><i class="foreignphrase">The Linux Documentation Project</i></span>, soit le 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 <tt class="filename">howto-html-en</tt> et <tt class="filename">howto-html-fr</tt> pour les éditions anglaise et française respectivement), ces <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> procurent des réponses ou solutions spécifiques à des problèmes reliés à votre système. Cette documentation se trouve dans le répertoire <tt class="filename">/usr/doc/HOWTO/HTML/fr/</tt> pour la version française. Ce sont des fichiers <span class="acronym">HTML</span> consultables et imprimables à partir de n'importe quel navigateur Web.</p><p><a name="BId-get-doc-chapter-pa26"></a>La liste est très longue. Pour vous en convaincre, consultez l'index à partir du menu principal de votre gestionnaire de fenêtres : <span class="guimenu">Documentation</span>-><span class="guimenuitem">Howto en français</span>. Si vous tombez sur un problème que vous n'arrivez pas à résoudre, trouver le <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> correspondant s'il existe. Le meilleur point de départ est de le lire, et il est très probable que vous y trouviez la solution. Vous apprendrez aussi beaucoup de choses en le lisant. Entre autres sujets sont couverts le réseau (<tt class="filename">NET-3-HOWTO</tt>), la configuration de cartes son (<tt class="filename">Sound-HOWTO</tt>), comment graver un <span class="acronym">CD</span> (<tt class="filename">CD-Writing-HOWTO</tt>), la configuration de <span class="acronym">NIS</span> et <span class="acronym">NFS</span>, ainsi que plusieurs autres sujets.</p><p><a name="BId-get-doc-chapter-pa27"></a>Il faut cependant faire attention aux dates de dernière modification des <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> : certains d'entre eux n'ont pas été mis à jour depuis des lustres. Par conséquent, il est probable que leur contenu ne soit plus valide. Donc, méfiez-vous des vieux <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> traitant particulièrement de configuration de matériel puisque <span class="application">GNU/Linux</span> évolue très vite. Souvenez-vous aussi que le qualificatif « <span class="quote">ancien</span> » 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é !</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="images/note.png"></td><th align="left">Note</th></tr><tr><td colspan="2" align="left" valign="top"><p><a name="BId-get-doc-chapter-pa28"></a>Les <span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span> sont disponibles en ligne sur le site du <a href="http://fr.tldp.org/" target="_top"><span class="acronym">TLDP</span></a> et susceptibles d'y être légèrement plus à jour. Consultez aussi les <a href="http://fr.tldp.org/howtos.php" target="_top"><span class="foreignphrase"><i class="foreignphrase">HOWTO</i></span></a> et la <a href="http://tldp.org/docs.html#faq" target="_top">Foire aux Questions ou <span class="acronym">FAQ</span></a>, en anglais.</p></td></tr></table></div></div><div class="sect2" lang="fr"><div class="titlepage"><div><div><h3 class="title"><a name="id2545228"></a>Le répertoire /usr/doc</h3></div></div><div></div></div><p><a name="BId-get-doc-chapter-pa29"></a>Quelques paquetages viennent également avec leur propre documentation. Ils sont placés dans un sous-répertoire de <tt class="filename">/usr/doc</tt> et leur nom est souvent celui du paquetage. Malheureusement, cette documentation est souvent en anglais. </p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="get-doc-chapter.html">Précédent</a> </td><td width="20%" align="center"><a accesskey="u" href="get-doc-chapter.html">Niveau supérieur</a></td><td width="40%" align="right"> <a accesskey="n" href="ch06s02.html">Suivant</a></td></tr><tr><td width="40%" align="left" valign="top">Chapitre 6. Où obtenir de la documentation </td><td width="20%" align="center"><a accesskey="h" href="index.html">Sommaire</a></td><td width="40%" align="right" valign="top"> Comment résoudre un problème sous Mandrakelinux</td></tr></table></div></body></html>