[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

[rfr] man://apt-listchanges.fr.sgml

Bonsoir,

Merci pour les relectures de cette page de manuel.

Olivier


<!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>
  <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 entrées 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 installée sur le système.
    </para>

    <para>Il réalise cela en extrayant les entrées appropriées des fichiers
      NEWS.Debian et changelog<optional>.Debian</optional>, qui se trouvent
      habituellement dans le répertoire
      <filename>/usr/share/doc/</filename><replaceable>paquet</replaceable>,
      de l'archive d'un paquet Debian.
    </para>

    <para>
      Prenant une série de noms de fichiers en argument (ou lu depuis apt si
      l'option <option>--apt</option> est utilisée),
       <command>apt-listchanges</command> va parcourir les fichiers (supposés
       être des archives de paquets Debian) à la recherche des entrées appropriées
       et va en afficher un résumé 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 (fournit par apt)
            ayant un formatage spécial, plutôt que depuis la ligne de commande,
            et respecte certaines options spécifiques d'apt configuration
            d'apt. Ce tube doit être au format «&nbsp;version&nbsp;2&nbsp;», spécifié dans le
            fichier de configuration d'apt.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
        <TERM><option>-v, --verbose</option>
        </TERM>
        <LISTITEM>
          <PARA>Affiche des informations additionnelles (généralement non désirées).
            Par exemple, cela affiche un message lorsqu'un paquet d'une version
            identique ou inférieure est sur le point d'être installé, ou lorsqu'un
            paquet est sur le point d'être installé pour la première fois.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>
      <VARLISTENTRY>
        <TERM><option>-f, --frontend</option>
        </TERM>
        <LISTITEM>
          <PARA>
            Sélectionne 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 pager favori pour l'affichage. Par défaut,
                  la variable d'environnement PAGER sera utilisée. L'option
                  «&nbsp;pager&nbsp;» peut être spécifiée dans le fichier de
                  configuration pour sélectionner un pager spécifique à
                  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 défaut, la variable
                  d'environnement PAGER sera utilisée.  L'option
                  «&nbsp;browser&nbsp;» peut être spécifiée dans le fichier de
                  configuration pour sélectionner un navigateur spécifique à
                  utiliser avec apt-listchanges.
                </para>
              </listitem>
            </varlistentry>

            <VARLISTENTRY>
              <TERM>xterm-pager</TERM>
              <LISTITEM>
                <PARA>
                  Utilise votre pager favori pour l'affichage, mais le fait
                  dans un xterm  en arrière-plan (en utilisant l'alternative
                  pointée par x-terminal-emulator). Cela vous permet de poursuivre
                  la mise à jour tout en continuant à consulter le journal des
                  modifications. Vous pouvez spécifier 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 résultat sur la sortie standard.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <VARLISTENTRY>
              <TERM>mail</TERM>
              <LISTITEM>
                <PARA>
                  Envoie un courriel à l'adresse donnée grâce à --email-address sans
                  afficher les journaux de modifications.
                </PARA>
              </LISTITEM>
            </VARLISTENTRY>

            <VARLISTENTRY>
              <TERM>none</TERM>
              <LISTITEM>
                <PARA>
                  Ne fait rien. Cela peut être utiliser 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>
            En plus de l'afficher, une copie du journal des modifications
            est envoyée à l'adresse spécifiée. Pour ne recevoir les
            journaux de modification que par courriel, utiliser cette
            option en conjonction à 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é affichés,
            demande à l'utilisateur s'il veut continuer ou interrompre
            l'installation. Si l'utilisateur choisit d'interrompre, une
            valeur de sortie non nulle est renvoyée et apt abandonne.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <VARLISTENTRY>
        <TERM><OPTION>-a, --all</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Au lieu d'afficher uniquement les entrées des journaux plus récentes
            que la version du paquet en cours d'installation, affiche
            la totalité du journal des modifications du paquet. Cela 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 va demander à apt-listchanges de garder
            une trace de la dernière version d'un paquet pour
            laquelle le journal à été affichée afin d'éviter
            de réafficher le même journal la fois suivante. La base
            de données est conservée dans le fichier donné en argument.
            Spécifiez «&nbsp;none&nbsp;» pour désactiver 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 nouveautés (récupérés de NEWS.Debian et d'autres), des journaux de
            modifications (récupérés de changelog.Debian et d'autres) ou des deux.
            Par défaut, les deux sont affichés.
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

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

      <VARLISTENTRY>
        <TERM><OPTION>-h, --headers</OPTION></TERM>
        <LISTITEM>
          <PARA>
            Ces options permettent de faire insérer, par apt-listchanges, un
            en-tête 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 diffère du nom du paquet
            source).
          </PARA>
        </LISTITEM>
      </VARLISTENTRY>

      <varlistentry>
        <term><option>--debug</option></term>
        <listitem>
          <para>Affiche quelques informations de débogage.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term><option>--profile=<replaceable>nom</replaceable></option></term>
        <listitem>
          <para>Sélectionne un profil d'options.
          <replaceable>nom</replaceable> correspond à une section dans le fichier
          <filename>/etc/apt/listchanges.conf</filename>.  Les valeurs par défaut
          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>
            Utilisée 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 même nom
          que l'option équivalente en ligne de commande à l'exception d'éventuels
          traits d'union qui doivent être remplacés 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 précédent indique que
          dans le mode ligne de commande, l'interface par défaut
          doit être «&nbsp;pager&nbsp;». Dans le mode apt,
          l'interface sera par défaut xterm-pager, une copie des
          journaux (s'il y en a) devra être envoyée au super utilisateur
          («&nbsp;root&nbsp;») et apt-listchanges demandera une confirmation.
          Si apt-listchanges est appelé avec --profile=perso, l'interface browser
          sera utilisée et lancera mozilla.</para>

        </listitem>
      </varlistentry>

      <varlistentry>
        <term>/var/lib/apt/listchanges.db</term>
        <listitem><para>Base de données des déja-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;, août 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:
-->
Reply to: