[rfr2] man://apt-listchanges.fr.sgml
Bonsoir,
une deuxième passe pour ce fichier, j'ai finalement gardé « journal des
modifications » pour « changelog » et mis « pageur » pour
« pager »
a+
nive
<!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>
Avec des noms de fichiers en argument (ils peuvent être lus depuis apt si
l'option <option>--apt</option> est utilisée),
<command>apt-listchanges</command> examine les fichiers (supposés
être des archives de paquets Debian) à la recherche des entrées appropriées
et en affiche 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 au format spécial
(fourni par apt), plutôt que depuis la ligne de commande,
et respecte certaines options spécifiques à apt dans le fichier de
configuration. Ce tube doit être au format « version 2 »,
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 :
</PARA>
<VARIABLELIST>
<VARLISTENTRY>
<TERM>pager</TERM>
<LISTITEM>
<PARA>
Utilise votre pageur favori pour l'affichage. Par défaut,
la variable d'environnement PAGER sera utilisée. L'option
« pager » peut être spécifiée dans le fichier de
configuration pour sélectionner un pageur 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
« browser » 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 pageur 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 « xterm » 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 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 spécifiée. Pour ne recevoir les
journaux de modification que par courriel, utiliser cette
option avec la pseudo-interface « mail ».
</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. 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 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 « none » 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 dans NEWS.Debian et d'autres), des journaux de
modifications (récupérés dans 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 une aide courte.
</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 des 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 « apt » lors d'un appel depuis apt et « cmdline » 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 « pager ». 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
(« root ») 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
<mdz@debian.org>
</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 <olivier.trichet@centrale-lille.net>, 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: