Attachment 57870 Details for Bug 91216 – gentoolkit.xml.diff

[patch] gentoolkit.xml.diff

gentoolkit.xml.diff (text/plain), 9.86 KB, created by Clément VARALDI on 2005-05-02 13:06:02 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Clément VARALDI

Created: 2005-05-02 13:06:02 UTC

Size: 9.86 KB

patch

obsolete

>--- gentoolkitfr.xml	Wed Apr 27 09:37:33 2005
>+++ gentoolkitfr_new.xml	Mon May  2 21:58:18 2005
>@@ -20,11 +20,18 @@
> <author title="Correcteur">
>   <mail link="neysx@gentoo.org">Xavier Neys</mail>
> </author>
>+<author title="Correcteur">
>+  <mail link="karltk@gentoo.org">Karl Trygve</mail>
>+</author>
>+<author title="Correcteur">
>+  <mail link="yoswink@gentoo.org">JosÃ© Luis Rivero</mail>
>+</author>
> <author title="Traducteur">
>   <mail link="ribosome@gentoo.org">Olivier Fisette</mail>
> </author>
>-
>-
>+<author title="Traducteur">
>+  <mail link="Clement@varaldi.org">ClÃ©ment Varaldi</mail>
>+</author>
> 
> <abstract>
> Gentoolkit est un ensemble d'outils qui facilitent l'administration d'un
>@@ -32,8 +39,10 @@
> Ã  l'utilisation de quelques-uns de ces outils.
> </abstract>
> 
>-<version>1.6</version>
>-<date>2005-04-07</date>
>+
>+
>+<version>1.7</version>
>+<date>2005-04-23</date>
> 
> <chapter>
> <title>Introduction</title>
>@@ -54,8 +63,10 @@
> Il existe Ã  l'heure actuelle deux versions de gentoolkit&nbsp;:
> <c>app-portage/gentoolkit</c> et <c>app-portage/gentoolkit-dev</c>. La premiÃ¨re
> contient des scripts servant Ã  l'administration systÃ¨me alors que la seconde
>-rassemble des scripts facilitant le dÃ©veloppement de Gentoo. Le prÃ©sent
>-document ne discutera que de gentoolkit.
>+rassemble des scripts facilitant le dÃ©veloppement de Gentoo. Si vous Ãªtes
>+dÃ©veloppeur vous pouvez inclure votre script Ã  <c>gentoolkit-dev</c> en
>+contactant le mainteneur de Gentoolkit. Ce document ne traitera que de
>+Gentoolkit.
> </note>
> 
> <p>
>@@ -115,19 +126,256 @@
> <c>epm</c> (et par l'outil <c>qpkg</c> maintenant obsolÃ¨te) tout en ajoutant
> ses propres fonctions qui le rendent particuliÃ¨rement utile. <c>equery
> --help</c> vous donnera la liste complÃ¨te des options. Ã terme, <c>equery</c>
>-remplacera complÃ¨tement <c>etcat</c>.
>+pourrait remplacer complÃ¨tement <c>etcat</c>.
> </p>
> 
> <note>
> Les fonctionnalitÃ©s listÃ©es par <c>equery --help</c> ne sont pas toutes
> implÃ©mentÃ©es pour l'instant. Celles qui ne le sont pas sont clairement
>-indiquÃ©es comme telles.
>+indiquÃ©es comme telles. Vous remarquerez Ã©galement que toutes les commandes
>+disposent d'une option courte, comme par exemple <c>b</c> Ã  la place de
>+<c>belongs</c>.
>+</note>
>+
>+<note>
>+Vous devez savoir de plus qu'actuellement le format de sortie n'est pas le mÃªme
>+si vous envoyez les donnÃ©es Ã  travers un pipe ou non. Le format en pipe a Ã©tÃ©
>+simplifiÃ© pour Ãªtre plus facile Ã  manipuler avec des outils classiques mais
>+est peu populaire et sera probablement modifiÃ© dans le futur. Si vous Ã©crivez
>+des scripts utilisant equery vous devez vous tenir au courant des changements.
> </note>
> 
> </body>
> </section>
> <section>
>-<title>Obtenir la taille d'un paquet</title>
>+<title>Trouver de quel paquet provient un fichier</title>
>+<body>
>+
>+<p>
>+<c>equery</c> permet Ã©galement de trouver le paquet auquel un fichier appartient
>+en utilisant la commande <c>belongs</c> (ou plus simplement <c>b</c>).
>+</p>
>+
>+<pre caption="Trouver l'ebuild ayant installÃ© un certain fichier">
>+# <i>equery belongs /usr/bin/xmms</i>
>+[ Searching for file(s) /usr/bin/xmms in *... ]
>+media-sound/xmms-1.2.10-r9 (/usr/bin/xmms)
>+</pre>
>+
>+<p>
>+En utilisant l'option <c>-f</c> vous pouvez chercher les paquets installant des
>+fichiers correspondant Ã  une expression rÃ©guliÃ¨re. L'option <c>-e</c> est utile
>+pour terminer la recherche immÃ©diatement aprÃ¨s avoir trouvÃ© une rÃ©ponse.
>+</p>
>+
>+</body>
>+</section>
>+<section>
>+<title>VÃ©rifier l'intÃ©gritÃ© d'un paquet</title>
>+<body>
>+
>+<p>
>+Il est parfois utile de vÃ©rifier l'intÃ©gritÃ© d'un paquet. <c>equery</c> peut
>+vÃ©rifier la somme md5 ainsi que la marque horaire d'un paquet pour indiquer s'il
>+a Ã©tÃ© corrompu, remplacÃ© ou enlevÃ©.
>+</p>
>+
>+<pre caption="IntÃ©gritÃ© correcte d'un paquet">
>+# <i>equery check gentoolkit</i>
>+[ Checking app-portage/gentoolkit-0.2.0 ]
>+ * 54 out of 54 files good
>+</pre>
>+
>+<p>
>+Vous remarquerez que si vous chanez des fichiers de configuration aprÃ¨s
>+l'installation ils seront probablement rapportÃ©s comme Â«&nbsp;not good&nbsp;Â»,
>+soit incorrects.
>+</p>
>+
>+</body>
>+</section>
>+<section>
>+<title>Lister tous les paquets dÃ©pendant de...</title>
>+<body>
>+
>+<p>
>+<c>equery</c> est capable de lister toutes les dÃ©pendances directes d'un paquet.
>+Nous utiliserons pour cela la fonction <c>depends</c> et son utilisation est
>+simple&nbsp;:
>+</p>
>+
>+<pre caption="Chercher les paquets dÃ©pendant de pygtk">
>+# <i>equery depends pygtk</i>
>+[ Searching for packages depending on pygtk... ]
>+app-office/dia-0.93
>+dev-python/gnome-python-2.0.0-r1
>+gnome-extra/gdesklets-core-0.26.2
>+media-gfx/gimp-2.0.4
>+x11-libs/vte-0.11.11-r1
>+</pre>
>+
>+</body>
>+</section>
>+<section>
>+<title>Graphes de dÃ©pendances</title>
>+<body>
>+
>+<p>
>+<c>equery</c> est capable de vous donner un graphe des dÃ©pendances pour un
>+paquet donnÃ©. Le graphe de dÃ©pendances liste tous les paquets qui ont une
>+dÃ©pendance directe ou indirecte pour le paquet en question.
>+</p>
>+
>+<pre caption="Graphe de dÃ©pendances pour cdrtools">
>+# <i>equery depgraph cdrtools</i>
>+Displaying dependencies for app-cdr/cdrtools-2.01_alpha37
>+`-- app-cdr/cdrtools-2.01_alpha37
>+ `-- sys-libs/glibc-2.3.4.20040808 (virtual/libc)
>+  `-- sys-kernel/linux-headers-2.4.22 (virtual/os-headers)
>+   `-- sys-apps/baselayout-1.10.4
>+    `-- sys-apps/sysvinit-2.85-r1
>+     `-- sys-apps/gawk-3.1.3-r1
>+      `-- sys-apps/util-linux-2.12-r4
>+          `-- sys-apps/sed-4.0.9
>+              `-- sys-libs/ncurses-5.4-r4
>+                  `-- sys-apps/pam-login-3.14
>+                  `-- sys-libs/pam-0.77-r1
>+                 `-- sys-libs/cracklib-2.7-r10
>+               `-- sys-apps/miscfiles-1.3-r1
>+              `-- app-arch/gzip-1.3.5-r1
>+              `-- sys-apps/portage-2.0.50-r10
>+</pre>
>+
>+<p>
>+Par exemple si glibc est une dÃ©pendance directe pour cdrtools, linux-headers
>+n'est qu'une dÃ©pendance indirecte. Remarquez que la sortie indique Ã©galement
>+des informations sur les paquets virtuels. Dans l'exemple ci-dessus
>+<c>cdrtools</c> est en fait Ã©crit comme nÃ©cessitant virtual/libc et non
>+sys-libs/glibc. Mais dans l'exemple donnÃ©, le paquet virtuel virtual/libc
>+sera satisfait grÃ¢ce Ã  l'installation de sys-libs/glibc.
>+</p>
>+
>+</body>
>+</section>
>+<section>
>+<title>Lister les fichiers appartenant Ã  un ebuild</title>
>+<body>
>+
>+<p>
>+<c>equery</c> peut lister les fichiers qui appartiennent Ã  un ebuild installÃ©.
>+Si vous ne savez pas quels fichiers ont Ã©tÃ© isntallÃ©s par Gentoolkit sur le
>+systÃ¨me vous pourrez utiliser <c>equery</c> pour les obtenir.
>+</p>
>+
>+<pre caption="Lister les fichiers de Gentoolkit">
>+#<i> equery files gentoolkit</i>
>+[ Searching for packages matching gentoolkit... ]
>+app-portage/gentoolkit-0.2.0
>+* Contents of app-portage/gentoolkit-0.2.0:
>+/usr
>+/usr/bin
>+/usr/bin/equery
>+/usr/bin/etcat
>+/usr/bin/euse
>+/usr/bin/glsa-check
>+/usr/bin/qpkg
>+/usr/bin/revdep-rebuild
>+/usr/lib
>+/usr/lib/gentoolkit
>+/usr/lib/gentoolkit/pym
>+/usr/lib/gentoolkit/pym/gentoolkit
>+/usr/lib/gentoolkit/pym/gentoolkit/__init__.py
>+/usr/lib/gentoolkit/pym/gentoolkit/gentoolkit.py
>+/usr/lib/gentoolkit/pym/gentoolkit/pprinter.py
>+/usr/lib/gentoolkit/pym/glsa.py
>+/usr/sbin
>+/usr/share
>+/usr/share/doc
>+/usr/share/doc/gentoolkit-0.2.0_pre10
>+
>+[...]
>+</pre>
>+
>+<p>
>+La commande <c>files</c> de <c>equery</c> propose quelques options pour modifier
>+la sortie. Vous pouvez y jeter un Åil en lisant la page de manuel de
>+<c>equery</c>.
>+</p>
>+
>+</body>
>+</section>
>+<section>
>+<title>Chercher les paquets utilisant un paramÃ¨tre USE spÃ©cifique</title>
>+<body>
>+
>+<p>
>+Si vous souhaitez trouver quels paquets sur votre systÃ¨me peuvent utiliser un
>+paramÃ¨tre USE bien prÃ©cis, <c>equery</c> dispose de la fonction <c>hasuse</c>.
>+</p>
>+
>+<pre caption="Chercher les paquets utilisant le paramÃ¨tre USE mozilla">
>+# <i>equery hasuse mozilla</i>
>+[ Searching for USE flag mozilla in all categories among: ]
>+ * installed packages
>+[I--] [  ] dev-java/blackdown-jre-1.4.2.01 (1.4.2)
>+[I--] [  ] mail-client/evolution-2.0.2 (2.0)
>+</pre>
>+
>+</body>
>+</section>
>+<section>
>+<title>Lister les paquets</title>
>+<body>
>+
>+<p>
>+<c>equery</c> dispose d'un outil puissant permettant de lister les paquets
>+appartenant Ã  notre systÃ¨me, Ã  Portage ou mÃªme Ã  un Â«&nbsp;overlay&nbsp;Â». Nous
>+allons l'essayer&nbsp;:
>+</p>
>+
>+<pre caption="Lister les paquets avec equery">
>+# <i>equery list gentoolkit</i>
>+[ Searching for package 'gentoolkit' in all categories among: ]
>+ * installed packages
>+[I--] [  ] app-portage/gentoolkit-0.2.0 (0)
>+</pre>
>+
>+<p>
>+La recherche standard cherchera parmi les paquets installÃ©s un nom donnÃ©. S'il
>+est trouvÃ© les informations suivantes seront retournÃ©es&nbsp;: l'Ã©tat du
>+paquet sur le systÃ¨me dans les premiers crochets (I pour les paquets InstallÃ©s,
>+P pour Portage et O pour Overlay), les masques possibles dans les seconds (~ par
>+mot-clefs, - par architectures ou M pour MasquÃ©s en dur), puis la catÃ©gorie et
>+le nom complet, et enfin le SLOT dans lequel le paquet est mis.
>+</p>
>+
>+<p>
>+Dans cet autre exemple nous allons utiliser des options locales pour chercher
>+des paquets dans notre arbre de Portage et dans l'overlay.
>+</p>
>+
>+<pre caption="Utilisation d'options locales avec equery">
>+# <i>equery list -p -o vim</i>
>+[ Searching for package 'vim' in all categories among: ]
>+ * installed packages
>+[I--] [  ] app-editors/vim-6.3-r4 (0)
>+ * Portage tree (/usr/portage)
>+[-P-] [M~] app-editors/vim-7.0_alpha20050126 (0)
>+[-P-] [M~] app-editors/vim-7.0_alpha20050201 (0)
>+[-P-] [  ] app-editors/vim-6.3-r2 (0)
>+[-P-] [M~] app-editors/vim-7.0_alpha20050122 (0)
>+[-P-] [M~] app-editors/vim-core-7.0_alpha20050126 (0)
>+[-P-] [  ] app-editors/vim-core-6.3-r3 (0)
>+[-P-] [M~] app-editors/vim-core-7.0_alpha20050122 (0)
>+[-P-] [M~] app-editors/vim-core-7.0_alpha20050201 (0)
>+[-P-] [  ] app-editors/vim-core-6.3-r4 (0)
>+ * overlay tree (/opt/ebuilds)
>+</pre>
>+
>+</body>
>+</section>
>+<section>
>+<title>Trouver la taille d'un paquet</title>
> <body>
> 
> <p>

Actions: View | Diff

Attachments on bug 91216: 57870 | 57872