Attachment 80036 Details for Bug 123197 – XML file containing the guide

XML file containing the guide

user-guide.xml (text/plain), 7.16 KB, created by Bertrand on 2006-02-17 12:05:11 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Bertrand

Created: 2006-02-17 12:05:11 UTC

Size: 7.16 KB

patch

obsolete

><?xml version='1.0' encoding="UTF-8"?>
>
>
>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
><guide link="/proj/fr/eselect/user-guide.xml" lang="fr">
><title>Manuel d'utilisation d'eselect</title>
>
><author title="Auteur">
><mail link="ciaranm@gentoo.org">Ciaran McCreesh</mail>
></author>
><author title="Auteur">
><mail link="kugelfang@gentoo.org">Danny van Dyk</mail>
></author>
><author title="Correcteur">
><mail link="fox2mike@gmail.com">Shyam Mani</mail>
></author>
><author title="Traducteur">
><mail link="koppatroopa@yahoo.fr">Bertrand Coppa</mail>
></author>
>
><abstract>
>Ce document est un guide de rÃ©fÃ©rence complet pour les utilisateurs de l'outil
>eselect.
></abstract>
>
>
>
><license/>
>
><version>1.0.251</version>
><date>2006-02-12</date>
>
><chapter>
><title>Introduction</title>
><section>
><title>Un rapide apperÃ§u</title>
><body>
>
><p>
>eselect est un outil de configuration et d'administration pour les systÃ¨mes
>Gentoo. Il agit <e>directement</e> sur le comportement du systÃ¨me et doit donc
>Ãªtre utilisÃ© avec prÃ©cautions par l'administrateur systÃ¨me. eselect est une
>structure modulaire pour Ã©crire des utilitaires de configuration. Cette
>structure est constituÃ©e de&nbps;:
></p>
>
><ul>
><li>
>un programme principal appelÃ© <c>eselect</c>.
></li>
><li>
>divers modules (fichiers *.eselect) qui s'occupent de diffÃ©rentes tÃ¢ches.
></li>
><li>
>plusieurs bibliothÃ¨ques qui aident Ã  assurer un comportement cohÃ©rent et
>simplifie la crÃ©ation de nouveaux modules.
></li>
></ul>
>
><p>
>Un module fournit plusieurs actions. Il y a habituellement deux types
>d'actions&nbsp;: soit on affiche des informations (<c>list</c> et <c>show</c>
>sont assez usuelles), soit on met Ã  jour le systÃ¨me d'une maniÃ¨re ou d'une
>autre (par exemple, <c>set</c> et <c>update</c>.) Chaque module dispose aussi
>des actions <c>help</c> et <c>usage</c> qui expliquent comment utiliser le
>module.
></p>
>
><note>
>Certains modules installent des liens symboliques vers le programme principal.
>eselect gÃ¨re ceci de faÃ§on intelligente. Par exemple, il fait l'association
>entre <c>profile-config list</c> et <c>eselect profile list</c>.
></note>
>
></body>
></section>
><section>
><title>Avantages pour les utilisateurs et les administrateurs systÃ¨me</title>
><body>
>
><p>
>Pour les utilisateurs et les administrateurs systÃ¨me, des outils qui ont Ã©tÃ©
>Ã©crits sous forme de modules eselect offrent de nombreux avantages par rapport
>Ã  l'approche traditionnelle Â«&nbsp;d'Ã©crire chaque outil Ã  partir de
>rien&nbsp;Â»&nbsp;:
></p>
>
><ul>
><li>
>Les modules d'eselect disposent d'une interface utilisateur cohÃ©rente - GrÃ¢ce Ã 
>la structure d'actions d'eselect, il n'est plus nÃ©cessaire de retenir ou de
>retrouver des dizaines d'options de type -x pour chaque outil. Le formatage de
>la sortie des modules est aussi conforme Ã  un standard.
></li>
><li>
>Format d'aide cohÃ©rent - Tous les modules disposent d'une documentation
>facilement accessible via les actions <c>help</c> et <c>usage</c>.
></li>
><li>
>Appelation cohÃ©rente des outils - Ce n'est pas la peine de retenir des dizaines
>de truc-config ou update-machin. Pour voir une liste des outils disponibles,
>il suffit de lancer <c>eselect</c> sans argument. Bien entendu, les outils
>du style truc-config sont toujours accessibles (par liens symboliques) si vous
>prÃ©fÃ©rez.
></li>
><li>
>Support garanti de <c>$ROOT</c> - Pour ceux d'entre vous utilisant
><c>$ROOT</c>, vous n'aurez pas Ã  vous prÃ©occuper de savoir si tel outil le
>gÃ¨re. Le support de <c>$ROOT</c> est obligatoire pour tous les modules eselect.
></li>
></ul>
>
></body>
></section>
><section>
><title>Avantages pour les dÃ©veloppeurs et les mainteneurs de paquets</title>
><body>
>
><p>
>Ãcrire votre outil sous forme d'un module eselect plutot qu'en partant de zero
>vous apporte divers avantages&nbsp;:
></p>
>
><ul>
><li>
>Temps de dÃ©veloppement raccourci - Le plus gros du travail a dÃ©jÃ  Ã©tÃ© fait.
>eselect fournit une sÃ©rie de bibliothÃ¨ques pour les taches communes et le
>programme principal <c>eselect</c> gÃ¨re le plus dur pour vous. Tout ce qu'il
>vous faut faire, c'est fournir les actions et toute fonction particuliÃ¨re 
>dont vous avez besoin.
></li>
><li>
>Actions automatiques - Les actions <c>help</c> et <c>usage</c> sont gÃ©nÃ©rÃ©es
>automatiquement Ã  partir de vos actions, il n'est donc pas nÃ©cessaire de perdre
>son temps Ã  se soucier de les maintenir Ã  jour.
></li>
><li>
>Comportement cohÃ©rent et facile - Comme la gestion de la ligne de commande et
>l'entrÃ©e/sortie est divisÃ© dans les fonctions de bibliothÃ¨ques, Ã©crire un
>module Â«&nbsp;standard&nbsp;Â» qui se comporte de faÃ§on cohÃ©rente avec les
>autres outils est vraiment simple.
></li>
><li>
>Format familier - Pour les dÃ©veloppeurs Gentoo, le format de module eselect va
>vite leur sembler familier. C'est un fichier bash avec une structure trÃ¨s
>similaire Ã  celle des ebuilds.
></li>
></ul>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Utiliser eselect</title>
><section>
><title>Utilisation</title>
><body>
>
><p>
>eselect doit Ãªtre invoquÃ© de la maniÃ¨re suivante&nbsp;:
></p>
>
><pre caption="eselect - syntaxe gÃ©nÃ©rale">
># <i>eselect [&lt;global options&gt;] &lt;module&gt; &lt;action&gt; &lt;options&gt;</i>
></pre>
>
><p>
>eselect dispose d'une appelation cohÃ©rente des actions dans la plupart de ces
>modules. Il n'y a qu'une option globale pour le moment, <c>--no-color</c>, qui
>demande Ã  eselect de ne plus envoyer de sortie en couleur comme par dÃ©faut.
>Voici les noms d'action standards. Chaque module peut fournir une partie de ces
>actions&nbsp;:
></p>
>
><ul>
><li>
><c>help</c> - affiche l'Ã©cran d'aide du module.
></li>
><li>
><c>usage</c> - affiche les informations sur comment invoquer les actions
>du module.Print information on how to invoke the modules actions.
></li>
><li>
><c>version</c> - affiche la version du module et autres informations utiles.
></li>
><li>
><c>list</c> - affiche les options disponibles.
></li>
><li>
><c>show</c> - affiche la ou les configuration(s) active.
></li>
><li>
><c>set</c> - choisit une des options offertes par <c>list</c>.
></li>
><li>
><c>enable</c> - active une des fonctionnalitÃ©s spÃ©cifiques du module.
></li>
><li>
><c>disable</c> - dÃ©sactive une des fonctionnalitÃ©s spÃ©cifiques du module.
></li>
><li>
><c>update</c> - idem <c>set</c>, mais selectionne automatiquement une option
>plutÃ´t que de la prendre en paramÃ¨tre.
></li>
><li>
><c>scan</c> - rÃ©cupÃ¨re des informations sur le systÃ¨me et les conserve pour un
>usage futur du module.
></li>
></ul>
>
><p>
>Une session typique ressemblera Ã  ceci pour la plupart des modules&nbsp;:
></p>
>
><pre caption="Session eselect d'exemple">
><comment>(Trouver les options disponibles pour un module)</comment>
># <i>eselect &lt;module&gt; list</i>
>These selections are available:
>	[1]&lt;first&gt;
>	[2]&lt;second&gt;
><comment>(Activer une option)</comment>
># <i>eselect &lt;module&gt; set &lt;first&gt;</i>
><comment>(Afficher la configuration actuelle)</comment>
># <i>eselect &lt;module&gt; show</i>
>Active Selection:
>	&lt;item1&gt;
></pre>
>
><p>
>En gÃ©nÃ©ral, vous pouvez activer les objets par nom ou par numÃ©ro.
></p>
>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 123197: 80036 | 80037