Sophie

Sophie

distrib > Mandriva > 10.0-com > i586 > by-pkgid > 664c05250964d29fcf1d0bb310959fbc > files > 124

mandrake-doc-fr-10.0-5.1.100mdk.noarch.rpm

<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] &lt;page de manuel&gt;</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>-&gt;<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>