File: apt-listchanges.fr.sgml

package info (click to toggle)
apt-listchanges 2.72.5
  • links: PTS
  • area: main
  • in suites: etch-m68k
  • size: 536 kB
  • ctags: 100
  • sloc: python: 598; makefile: 108; sh: 79
file content (413 lines) | stat: -rw-r--r-- 13,733 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
<!doctype refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
  <!ENTITY debian  "<productname>Debian GNU/Linux</productname>">
  <!ENTITY docbook "<productname>DocBook</productname>">
]>

<!-- Manual page for debchanges, DocBook source file
     (C) 2000 Matt Zimmerman <mdz@debian.org>

     Based on the example page docbook-to-man.sgml from docbook-to-man

     $Id: apt-listchanges.sgml,v 1.29 2004/02/27 06:43:18 mdz Exp $
-->

<refentry lang=fr>
  <docinfo>
    <address>
      <email>mdz@debian.org</email>
    </address>
    <author>
      <firstname>Matt</firstname>
      <surname>Zimmerman</surname>
    </author>
    <date>2003-07-07</date>
  </docinfo>
  <refmeta>
    <refentrytitle>apt-listchanges</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>apt-listchanges</refname> <refpurpose>Affiche les nouvelles entres du
      journal des modifications des paquets de l'archive Debian
    </refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>apt-listchanges</command>
      <group choice=opt>
        <arg rep=repeat><replaceable>options</replaceable></arg>
      </group>

      <group choice=req>
        <arg><option>--apt</option></arg>
        <arg rep=repeat><replaceable>paquet.deb</replaceable></arg>
      </group>

    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>

    <para><command>apt-listchanges</command> est un outil qui affiche ce
       qui a chang dans la nouvelle version d'un paquet Debian par rapport
        la version actuellement installe sur le systme.
    </para>

    <para>Il ralise cela en extrayant les entres appropries des fichiers
      NEWS.Debian et changelog<optional>.Debian</optional>, qui se trouvent
      habituellement dans le rpertoire
      <filename>/usr/share/doc/</filename><replaceable>paquet</replaceable>,
      de l'archive d'un paquet Debian.
    </para>

    <para>
      Avec des noms de fichiers en argument (ils peuvent tre lus depuis apt si
      l'option <option>--apt</option> est utilise),
      <command>apt-listchanges</command> examine les fichiers (supposs
      tre des archives de paquets Debian)  la recherche des entres appropries
      et en affiche un rsum tri par ordre d'urgence.
    </para>

  </refsect1>

  <refsect1>
    <title>OPTIONS</title>

    <VARIABLELIST>
      <VARLISTENTRY>
        <TERM><option>--apt</option>
        </TERM>
        <LISTITEM>
          <PARA>Lit les noms de fichiers depuis un tube au format spcial 
	    (fourni par apt), plutt que depuis la ligne de commande,
            et respecte certaines options spcifiques  apt dans le fichier de 
	    configuration. Ce tube doit tre au format &nbsp;version&nbsp;2&nbsp;, 
	    spcifi dans le fichier de configuration d'apt.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
        <TERM><option>-v, --verbose</option>
        </TERM>
        <LISTITEM>
          <PARA>Affiche des informations additionnelles (gnralement non dsires).
            Par exemple, cela affiche un message lorsqu'un paquet d'une version
            identique ou infrieure est sur le point d'tre install, ou lorsqu'un
            paquet est sur le point d'tre install pour la premire fois.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
        <TERM><option>-f, --frontend</option>
        </TERM>
        <LISTITEM>
          <PARA>
            Slectionne l'interface  utiliser pour afficher l'information 
            l'utilisateur. Les interfaces disponibles actuellement sont&nbsp;:
          </PARA>
          <VARIABLELIST>
            <VARLISTENTRY>
              <TERM>pager</TERM>
              <LISTITEM>
                <PARA>
                  Utilise votre pageur favori pour l'affichage. Par dfaut,
                  la variable d'environnement PAGER sera utilise. L'option
                  &nbsp;pager&nbsp; peut tre spcifie dans le fichier de
                  configuration pour slectionner un pageur spcifique 
                  utiliser avec apt-listchanges.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <varlistentry>
              <term>browser</term>
              <listitem>
                <para>
                  Affiche le journal des modifications format en HTML dans un
                  navigateur web avec des hyperliens vers les pages de bugs et
                  pour les adresses lectroniques. Par dfaut, la variable
                  d'environnement BROWSER sera utilise.  L'option
                  &nbsp;browser&nbsp; peut tre spcifie dans le fichier de
                  configuration pour slectionner un navigateur spcifique 
                  utiliser avec apt-listchanges.
                </para>
              </listitem>
            </varlistentry>

            <VARLISTENTRY>
              <TERM>xterm-pager</TERM>
              <LISTITEM>
                <PARA>
                  Utilise votre pageur favori pour l'affichage, mais le fait
                  dans un xterm  en arrire-plan (en utilisant l'alternative
                  pointe par x-terminal-emulator). Cela vous permet de poursuivre
                  la mise  jour tout en continuant  consulter le journal des
                  modifications. Vous pouvez spcifier l'mulateur de terminal 
                  utiliser avec l'option &nbsp;xterm&nbsp; du fichier de configuration.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <varlistentry>
              <term>xterm-browser</term>
              <listitem>
                <para>
                  La conjonction des options xterm-pager et browser.
                  Cela convient uniquement aux navigateurs en mode texte.
                </para>
              </listitem>
            </varlistentry>

            <VARLISTENTRY>
              <TERM>text</TERM>
              <LISTITEM>
                <PARA>
                  Affiche, sans pause, le rsultat sur la sortie standard.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <VARLISTENTRY>
              <TERM>mail</TERM>
              <LISTITEM>
                <PARA>
                  Envoie un courriel  l'adresse donne grce  --email-address sans
                  afficher les journaux de modifications.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <VARLISTENTRY>
              <TERM>none</TERM>
              <LISTITEM>
                <PARA>
                  Ne fait rien. Cela peut tre utilis pour viter
                  qu'apt-listchanges ne se lance alors qu'il est configur
                  pour se lancer automatiquement depuis apt.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>
          </VARIABLELIST>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>--email-address=adresse</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Affichage du journal des modifications et envoi d'une copie 
             l'adresse spcifie. Pour ne recevoir les
            journaux de modification que par courriel, utiliser cette
            option avec la pseudo-interface &nbsp;mail&nbsp;.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>-c, --confirm</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Une fois que les journaux de modifications ont t affichs,
            demande  l'utilisateur s'il veut continuer ou interrompre
            l'installation. Si l'utilisateur choisit d'interrompre, une
            valeur de sortie non nulle est renvoye et apt abandonne.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>-a, --all</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Au lieu d'afficher uniquement les entres des journaux plus rcentes
            que la version du paquet en cours d'installation, affiche
            la totalit du journal des modifications du paquet. C'est
            utile pour voir la totalit du journal contenu dans un paquet .deb
            avant d'extraire ce dernier.

          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>--save_seen=fichier</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Cette option demande  apt-listchanges de garder
            une trace de la dernire version d'un paquet pour
            laquelle le journal  t affiche afin d'viter
            de rafficher le mme journal la fois suivante. La base
            de donnes est conserve dans le fichier donn en argument.
            Spcifiez &nbsp;none&nbsp; pour dsactiver cette fonctionnalit.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>--which={news|changelogs|both}</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Cette option permet de choisir entre l'affichage des messages
            de nouveauts (rcuprs dans NEWS.Debian et d'autres), des journaux de
            modifications (rcuprs dans changelog.Debian et d'autres) ou des deux.
            Par dfaut, les deux sont affichs.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>--help</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Affiche une aide courte.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>-h, --headers</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Ces options permettent de faire insrer, par apt-listchanges, un
            en-tte avant le journal de chaque paquet indiquant son nom,
            et le nom des paquets binaires qui sont en train d'tre mis
             jour (s'il y en a plus d'un ou s'il diffre du nom du paquet
            source).
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <varlistentry>
        <term><option>--debug</option></term>
        <listitem>
          <para>Affiche des informations de dbogage.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--profile=<replaceable>nom</replaceable></option></term>
        <listitem>
          <para>Slectionne un profil d'options.
          <replaceable>nom</replaceable> correspond  une section dans le fichier
          <filename>/etc/apt/listchanges.conf</filename>.  Les valeurs par dfaut
          sont &nbsp;apt&nbsp; lors d'un appel depuis apt et &nbsp;cmdline&nbsp; sinon.
          </para>
        </listitem>
      </varlistentry>

    </VARIABLELIST>

  </refsect1>

  <refsect1>
    <title>ENVIRONNEMENT</title>

    <variablelist>
      <varlistentry>
        <term>APT_LISTCHANGES_FRONTEND</term>
        <listitem><para>Interface  utiliser.</para></listitem>
      </varlistentry>
    </variablelist>

    <variablelist>
      <varlistentry>
        <term>BROWSER</term>
        <listitem><para>
            Utilise par l'interface browser, elle devrait contenir une commande
            qui attend l'URL d'un fichier HTML  afficher).</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>FICHIER</title>

    <variablelist>
      <varlistentry>
        <term>/etc/apt/listchanges.conf</term>

        <listitem>
          <para>Fichier de configuration. La plupart des options ont le mme nom
          que l'option quivalente en ligne de commande  l'exception d'ventuels
          traits d'union qui doivent tre remplacs par des traits de soulignement.
          </para>

          <example>
            <title>Exemple de fichier de configuration</title>
<programlisting>
[cmdline]
frontend=pager

[apt]
frontend=xterm-pager
email_address=root
confirm=1

[perso]
frontend=browser
browser=mozilla
</programlisting>
              </example>

          <para>Le fichier de configuration prcdent indique que
          dans le mode ligne de commande, l'interface par dfaut
          doit tre &nbsp;pager&nbsp;. Dans le mode apt,
          l'interface sera par dfaut xterm-pager, une copie des
          journaux (s'il y en a) devra tre envoye au super utilisateur
          (&nbsp;root&nbsp;) et apt-listchanges demandera une confirmation.
          Si apt-listchanges est appel avec --profile=perso, l'interface browser
          sera utilise et lancera mozilla.</para>

        </listitem>
      </varlistentry>

      <varlistentry>
        <term>/var/lib/apt/listchanges.db</term>
        <listitem><para>Base de donnes des dja-vus</para></listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1>
    <title>AUTEUR</title>

    <PARA>
      apt-listchanges a t crit par Matt Zimmerman
      &lt;mdz@debian.org&gt;
    </PARA>
  </refsect1>

   <refsect1>
    <title>VOIR AUSSI</title>

    <para>
      <citerefentry><refentrytitle>apt.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>
    </para>
  </refsect1>

  <refsect1>
    <title>TRADUCTEUR</title>
    <para>
      Traduction d'Olivier Trichet &lt;olivier.trichet@centrale-lille.net&gt;, aot 2004
    </para>
  </refsect1>
</refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->