Gentoo Archives: gentoo-commits

From: "Marion Age (titefleur)" <titefleur@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/doc/fr/handbook: hb-portage-files.xml
Date: Sun, 28 Oct 2007 21:30:34
Message-Id: E1ImFiE-0000nR-Lm@stork.gentoo.org
1 titefleur 07/10/28 21:30:26
2
3 Modified: hb-portage-files.xml
4 Log:
5 #197325 - Sync to 1.18 (Geekounet)
6
7 Revision Changes Path
8 1.10 xml/htdocs/doc/fr/handbook/hb-portage-files.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml?rev=1.10&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml?rev=1.10&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml?r1=1.9&r2=1.10
13
14 Index: hb-portage-files.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml,v
17 retrieving revision 1.9
18 retrieving revision 1.10
19 diff -u -r1.9 -r1.10
20 --- hb-portage-files.xml 7 Jun 2007 15:21:54 -0000 1.9
21 +++ hb-portage-files.xml 28 Oct 2007 21:30:26 -0000 1.10
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.0 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml,v 1.9 2007/06/07 15:21:54 cam Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/fr/handbook/hb-portage-files.xml,v 1.10 2007/10/28 21:30:26 titefleur Exp $ -->
28
29 <sections>
30
31 @@ -13,8 +13,8 @@
32 où il stocke à la fois ses fichiers et ses données.
33 </abstract>
34
35 -<version>1.10</version>
36 -<date>2007-05-26</date>
37 +<version>1.11</version>
38 +<date>2007-06-11</date>
39
40 <section>
41 <title>Les fichiers utilisés par Portage</title>
42 @@ -50,8 +50,8 @@
43 </p>
44
45 <p>
46 -Vous pouvez aussi définir ces variables dans votre environnement, mais nous
47 -ne recommandons pas cette pratique.
48 +Vous pouvez aussi définir ces variables dans votre environnement, mais nous ne
49 +recommandons pas cette pratique.
50 </p>
51
52 </body>
53 @@ -276,19 +276,19 @@
54 </section>
55
56 <section>
57 -<title>Fonctions de journalisation des évènements</title>
58 +<title>Fonctions de journalisation des événements</title>
59 <subsection>
60 <title>Les messages des ebuilds</title>
61 <body>
62
63 <p>
64 -Portage peut journaliser les messages des évènements relatifs aux ebuilds en
65 +Portage peut journaliser les messages des événements relatifs aux ebuilds en
66 utilisant un fichier pour chaque ebuild, mais uniquement si la variable
67 PORT_LOGDIR correspond à un répertoire dans lequel Portage peut écrire
68 (l'utilisateur portage doit disposer des permissions nécessaires).
69 Par défaut, cette variable n'est pas définie.
70 Si PORT_LOGDIR n'est pas définie, vous ne recevrez pas les messages des
71 -évènements relatifs à la construction des paquets avec le système de journal
72 +événements relatifs à la construction des paquets avec le système de journal
73 actuel, mais vous devriez en recevoir quelques-uns avec le nouveau système
74 appelé <c>elog</c>. Si PORT_LOGDIR est définie et que vous utilisez elog,
75 vous recevrez à la fois les messages de construction et tous ceux qui sont
76 @@ -296,68 +296,83 @@
77 </p>
78
79 <p>
80 -Portage propose un contrôle fin de la tenue du journal des évènements <e>via</e>
81 -<c>elog</c>&nbsp;:
82 +Portage propose un contrôle fin de la tenue du journal des événements
83 +<e>via</e> <c>elog</c>&nbsp;:
84 </p>
85
86 <ul>
87 <li>
88 PORTAGE_ELOG_CLASSES&nbsp;: Utilisez cette variable pour définir le type de
89 - message à enregistrer. Vous pouvez utiliser n'importe quelle combinaison
90 - à base d'<c>info</c>, <c>warn</c>, <c>error</c> et <c>log</c>, séparés
91 - par des espaces.
92 + message à enregistrer. Vous pouvez utiliser n'importe quelle combinaison à
93 + base d'<c>info</c>, <c>warn</c>, <c>error</c>, <c>log</c> et <c>qa</c>,
94 + séparés par des espaces.
95 <ul>
96 <li>
97 - info&nbsp;: Enregistre les messages «&nbsp;einfo&nbsp;» produits par un
98 - ebuild,
99 + <c>info</c>&nbsp;: Enregistre les messages «&nbsp;einfo&nbsp;» produits
100 + par un ebuild,
101 </li>
102 <li>
103 - warn&nbsp;: Enregistre les messages «&nbsp;ewarn&nbsp;» produits par un
104 - ebuild,
105 + <c>warn</c>&nbsp;: Enregistre les messages «&nbsp;ewarn&nbsp;» produits
106 + par un ebuild,
107 </li>
108 <li>
109 - error&nbsp;: Enregistre les messages «&nbsp;eerror&nbsp;» produits par
110 - un ebuild,
111 + <c>error</c>&nbsp;: Enregistre les messages «&nbsp;eerror&nbsp;»
112 + produits par un ebuild,
113 </li>
114 <li>
115 - log&nbsp;: Enregistre les messages «&nbsp;elog&nbsp;» que l'on trouve
116 - dans certains ebuilds.
117 + <c>log</c>&nbsp;: Enregistre les messages «&nbsp;elog&nbsp;» que l'on
118 + trouve dans certains ebuilds,
119 + </li>
120 + <li>
121 + <c>qa</c>&nbsp;: Enregistre les messages «&nbsp;QA Notice&nbsp;»
122 + produits par un ebuild.
123 </li>
124 </ul>
125 </li>
126 <li>
127 PORTAGE_ELOG_SYSTEM&nbsp;: Cette variable sert à choisir le ou les modules
128 qui vont traiter les messages. L'enregistrement est désactivé si cette
129 - variable reste nulle. Vous pouvez utiliser n'importe quelle combinaison
130 - des modules <c>save</c>, <c>custom</c>, <c>syslog</c> et <c>mail</c>,
131 - séparés par une espace. Vous devez sélectionner au moins un module pour
132 - utiliser elog.
133 + variable reste nulle. Vous pouvez utiliser n'importe quelle combinaison des
134 + modules <c>save</c>, <c>custom</c>, <c>syslog</c>, <c>mail</c>,
135 + <c>save_summary</c>, et <c>mail_summary</c>, séparés par un espace. Vous
136 + devez sélectionner au moins un module pour utiliser elog.
137 <ul>
138 <li>
139 - save&nbsp;: Ce module active la sauvegarde d'un enregistrement par
140 - paquet dans <path>$PORT_LOGDIR/elog</path>, ou
141 - <path>/var/log/portage/elog</path> si $PORT_LOGDIR n'est pas définie.
142 + <c>save</c>&nbsp;: Ce module active la sauvegarde d'un enregistrement
143 + par paquet dans <path>$PORT_LOGDIR/elog</path>, ou
144 + <path>/var/log/portage/elog</path> si $PORT_LOGDIR n'est pas définie,
145 + </li>
146 + <li>
147 + <c>custom</c>&nbsp;: Transmet tous les messages à une commande définie
148 + par l'utilisateur dans $PORTAGE_ELOG_COMMAND (détaillée plus bas),
149 </li>
150 <li>
151 - custom&nbsp;: Transmet tous les messages à une commande définie par
152 - l'utilisateur dans $PORTAGE_ELOG_COMMAND (détaillée plus bas).
153 + <c>syslog</c>&nbsp;: Envoie tous les messages à l'outil de
154 + journalisation des événements du système (syslog-ng par exemple),
155 </li>
156 - <li>syslog&nbsp;: Envoie tous les messages à l'outil de journalisation
157 - des évènements du système (syslog-ng par exemple).
158 + <li>
159 + <c>mail</c>&nbsp;: Envoie tous les messages à un serveur de mail défini
160 + dans $PORTAGE_ELOG_MAILURI, détaillée plus loin dans ce document. Cette
161 + fonction nécessite une version de Portage supérieure ou égale à 2.1.1,
162 + </li>
163 + <li>
164 + <c>save_summary</c>&nbsp;: Similaire à <c>save</c>, mais rassemble tous
165 + les messages dans <path>$PORT_LOGDIR/elog/summary.log</path>, ou
166 + <path>/var/log/portage/elog/summary.log</path> si $PORT_LOGDIR n'est pas
167 + définie,
168 </li>
169 <li>
170 - mail&nbsp;: Envoie tous les messages à un serveur mail défini dans
171 - $PORTAGE_ELOG_MAILURI, détaillée plus loin dans ce document. Cette
172 - fonction nécessite une version de Portage supérieure ou égale à 2.1.1.
173 + <c>mail_summary</c>: Similaire à <c>mail</c>, mais envoie tous les
174 + messages dans un seul mail quand emerge se termine.
175 </li>
176 </ul>
177 </li>
178 <li>
179 PORTAGE_ELOG_COMMAND&nbsp;: Cette option n'est utile qu'avec le module
180 <c>custom</c> activé. C'est ici que vous spécifiez la commande qui va
181 - traiter les évènements. Vous pouvez utiliser deux variables pour
182 - personnaliser votre commande&nbsp;: ${PACKAGE}, qui est le nom et la
183 - version du paquet, et ${LOGFILE}, qui est le chemin absolu du fichier
184 + traiter les événements. Vous pouvez utiliser deux variables pour
185 + personnaliser votre commande&nbsp;: ${PACKAGE}, qui est le nom et la version
186 + du paquet, et ${LOGFILE}, qui est le chemin absolu du fichier
187 d'enregistrement. Voici un exemple d'utilisation&nbsp;:
188 <ul>
189 <li>
190 @@ -374,8 +389,8 @@
191 </li>
192 <li>
193 Prenons l'exemple d'un serveur SMTP avec authentification basée sur le nom
194 - et le mot de passe et qui écoute sur un port particulier (par défaut,
195 - un serveur SMTP est configuré sur le port 25)&nbsp;:
196 + et le mot de passe et qui écoute sur un port particulier (par défaut, un
197 + serveur SMTP est configuré sur le port 25)&nbsp;:
198 <ul>
199 <li>
200 PORTAGE_ELOG_MAILURI="utilisateur@×××.domaine
201 @@ -385,8 +400,8 @@
202 </li>
203 <li>
204 PORTAGE_ELOG_MAILFROM&nbsp;: Vous permet de modifier le champ
205 - «&nbsp;From&nbsp;» (expéditeur) des mails envoyés par elog. Par défaut,
206 - ces mails ont pour expéditeur «&nbsp;portage&nbsp;».
207 + «&nbsp;From&nbsp;» (expéditeur) des mails envoyés par elog. Par défaut, ces
208 + mails ont pour expéditeur «&nbsp;portage&nbsp;».
209 </li>
210 <li>
211 PORTAGE_ELOG_MAILSUBJECT&nbsp;: Avec cette variable, vous changez le sujet
212
213
214
215 --
216 gentoo-commits@g.o mailing list