'\" t
.\"     Title: apt-listchanges
.\"    Author: Matt Zimmerman
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2017-07-08
.\"    Manual: Debian
.\"    Source: apt-listchanges
.\"  Language: French
.\"
.TH "APT\-LISTCHANGES" "1" "2017\-07\-08" "apt-listchanges" "Debian"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NOM"
apt-listchanges \- Affiche les nouvelles entrées du journal des modifications des paquets de l\*(Aqarchive Debian
.SH "SYNOPSIS"
.HP \w'\fBapt\-listchanges\fR\ 'u
\fBapt\-listchanges\fR [[\fIoptions\fR...]] {[\fB\-\-apt\fR] | [\fIpaquet\&.deb\fR...]}
.SH "DESCRIPTION"
.PP
\fBapt\-listchanges\fR
est un outil qui affiche ce qui a changé dans la nouvelle version d\*(Aqun paquet Debian par rapport à la version actuellement installée sur le système\&.
.PP
Il réalise cela en extrayant les entrées appropriées des fichiers NEWS\&.Debian et changelog[\&.Debian], qui se trouvent habituellement dans le répertoire
/usr/share/doc/\fIpaquet\fR, de l\*(Aqarchive d\*(Aqun paquet Debian\&.
.PP
Veuillez noter que dans l\*(Aqinstallation par défaut si
\fBapt\-listchanges\fR
est exécuté en tant que greffon d\*(AqAPT durant les mises à niveau, il affiche seulement les entrées de NEWS\&.Debian\&. Ce comportement peut être modifié avec l\*(Aqoption
\fB\-\-which\fR\&.
.PP
Si les entrées du journal des modifications sont affichées et que le
\fIpaquet\fR
ne fournit pas de fichier changelog[\&.Debian],
\fBapt\-listchanges\fR
appelle la commande
\fBapt\-get changelog\fR
pour télécharger le journal des modifications à partir du réseau\&. Ce comportement peut être désactivé avec l\*(Aqoption
\fB\-\-no\-network\fR\&.
.PP
Given a set of filenames as arguments (or read from apt when using
\fB\-\-apt\fR),
\fBapt\-listchanges\fR
will scan the files (assumed to be Debian package archives) for the relevant changelog entries, and display them all in a summary grouped by source package\&. The groups are sorted by the urgency of the most urgent change, and then by the package name\&. Changes within each package group are displayed in the order of their appearance in the changelog files, i\&.e\&. starting from the latest to the oldest; the
\fB\-\-reverse\fR
option can be used to alter this order\&.
.SH "OPTIONS"
.PP
\fBapt\-listchanges\fR
fournit les options suivantes pour contrôler son comportement\&. Pour la plupart d\*(Aqentre elles, il existe des entrées équivalentes dans le fichier de configuration, voir ci\-dessous le «\ \&FICHIER DE CONFIGURATION\ \&» pour plus de détails\&.
.PP
\fB\-\-apt\fR
.RS 4
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\*(Aqapt\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Affiche des informations additionnelles (généralement non désirées)\&. Par exemple, cela affiche un message lorsqu\*(Aqun paquet d\*(Aqune version identique ou inférieure est sur le point d\*(Aqêtre installé, ou lorsqu\*(Aqun paquet est sur le point d\*(Aqêtre installé pour la première fois\&.
.RE
.PP
\fB\-f, \-\-frontend\fR
.RS 4
Sélectionne l\*(Aqinterface à utiliser pour afficher l\*(Aqinformation à l\*(Aqutilisateur\&. Les interfaces disponibles actuellement sont\ \&:
.PP
pager
.RS 4
Utilise la commande
\fBsensible-pager\fR(1)
pour afficher la sortie\&. La variable d\*(Aqenvironnement PAGER est utilisée pour choisir votre pageur favori\&. L\*(Aqoption «\ \&pager\ \&» peut être spécifiée dans le fichier de configuration pour sélectionner un pageur spécifique à utiliser avec apt\-listchanges\&.
.RE
.PP
browser
.RS 4
Affiche le journal des modifications formaté en HTML dans un navigateur web avec des hyperliens vers les pages de bogues et pour les adresses électroniques avec la commande
\fBsensible-browser\fR(1)
qui examine la variable d\*(Aqenvironnement BROWSER pour choisir votre navigateur favori\&. L\*(Aqoption «\ \&browser\ \&» peut être spécifiée dans le fichier de configuration pour sélectionner un navigateur spécifique à utiliser avec apt\-listchanges\&.
.RE
.PP
xterm\-pager
.RS 4
Utilise votre pageur favori pour l\*(Aqaffichage, mais le fait dans un xterm en arrière\-plan (en utilisant l\*(Aqalternative 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\*(Aqémulateur de terminal à utiliser avec l\*(Aqoption «\ \&xterm\ \&» du fichier de configuration\&.
.RE
.PP
xterm\-browser
.RS 4
La conjonction des options xterm\-pager et browser\&. Cela convient uniquement aux navigateurs en mode texte\&.
.RE
.PP
text
.RS 4
Affiche, sans pause, le résultat sur la sortie standard\&.
.RE
.PP
syslog
.RS 4
Dumps output to syslog\&. Disabling the titled option is recommended\&.
.RE
.PP
log
.RS 4
Appends output to a log file, with an optional filter process\&. Disabling the titled option is recommended\&.
.RE
.PP
mail
.RS 4
Envoie un courriel à l\*(Aqadresse donnée grâce à \-\-email\-address sans afficher les journaux de modifications\&.
.RE
.PP
gtk
.RS 4
Ouvre une fenêtre pour afficher les modifications\&. Il est nécessaire que python3\-gi soit installé\&.
.RE
.PP
none
.RS 4
Ne fait rien\&. Cela peut être utilisé pour éviter qu\*(Aqapt\-listchanges ne se lance alors qu\*(Aqil est configuré pour se lancer automatiquement depuis apt\&.
.RE
.sp
Veuillez noter que apt\-listchanges essaiera de basculer vers un utilisateur non privilégié avant de générer des commandes dans les interfaces «\ \&browser\ \&», «\ \&xterm\-browser\ \&» et «\ \&xterm\-pager\ \&»\&. Néanmoins, cela ne s\*(Aqapplique pas actuellement à l\*(Aqinterface «\ \&pager\ \&»\&. Voir aussi les «\ \&VARIABLES D\*(AqENVIRONNEMENT\ \&» ci\-dessous\&.
.RE
.PP
\fB\-\-email\-address=\fR\fB\fIadresse\fR\fR
.RS 4
Affichage du journal des modifications et envoi d\*(Aqune copie à l\*(Aqadresse spécifiée\&. Pour ne recevoir les journaux de modifications que par courriel, utiliser cette option avec la pseudo\-interface «\ \&mail\ \&»\&.
.RE
.PP
\fB\-\-email\-format={text|html}\fR
.RS 4
Si l\*(Aqenvoi de copies de courriel est autorisée (voir
\fB\-\-email\-address\fR
ci\-dessus), cette option choisit si le courriel doit être envoyé comme de bonnes vieilles données en texte simple (ce qui est le comportement par défaut) ou comme des données HTML avec des liens cliquables, ce qui pourrait être plus pratique pour des gens qui utilisent un client de courrier graphique\&.
.RE
.PP
\fB\-c, \-\-confirm\fR
.RS 4
Une fois que les journaux de modifications ont été affichés, demande à l\*(Aqutilisateur s\*(Aqil veut continuer ou interrompre l\*(Aqinstallation\&. Si l\*(Aqutilisateur choisit d\*(Aqinterrompre, une valeur de sortie non nulle est renvoyée et apt abandonne\&.
.RE
.PP
\fB\-a, \-\-show\-all\fR
.RS 4
Au lieu d\*(Aqafficher uniquement les entrées des journaux plus récentes que la version du paquet en cours d\*(Aqinstallation, affiche la totalité du journal des modifications du paquet\&. C\*(Aqest utile pour voir la totalité du journal contenu dans un paquet \&.deb avant d\*(Aqextraire ce dernier\&.
.RE
.PP
\fB\-c, \-\-no\-network\fR
.RS 4
Dans les rares cas où un paquet binaire ne contient pas de fichier de journal des modifications (ou, pour être plus précis, aucun des paquets construits à partir du même paquet source qui sont traités ensemble comme un groupe),
\fBapt\-listchanges\fR, par défaut, exécute
\fBapt\-get changelog\fR
pour télécharger les journaux de modifications des serveurs réseau habituellement fournis par la distribution de votre système d\*(Aqexploitation\&. Cette option désactivera ce comportement, ce qui peut être utile, par exemple pour des machines derrière un pare\-feu\&.
.RE
.PP
\fB\-\-save\-seen=\fR\fB\fIfichier\fR\fR
.RS 4
Cette option demande à apt\-listchanges de garder une trace de la dernière version d\*(Aqun paquet pour laquelle le journal a été affiché afin d\*(Aqé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é\&.
.RE
.PP
\fB\-\-dump\-seen\fR
.RS 4
Affiche le contenu de la base de données des déjà\-vus sur la sortie standard comme une liste de lignes constituées du nom du paquet source et de sa dernière version vue, séparés par un espace\&. Cette option requiert que le chemin de la base de données des déjà\-vus soit connu\ \&: veuillez soit l\*(Aqindiquer avec l\*(Aqoption
\fB\-\-save\-seen\fR
ou passez l\*(Aqoption
\fB\-\-profile=apt\fR
pour qu\*(Aqil soit lu à partir du fichier de configuration\&.
.RE
.PP
\fB\-\-since=\fR\fB\fIversion\fR\fR
.RS 4
Cette option fera que apt\-listchanges montrera les entrées postérieures à la version indiquée\&. Avec cette option, le seul argument supplémentaire que vous pouvez passer est le nom d\*(Aqun fichier \&.deb\&.
.RE
.PP
\fB\-\-latest=\fR\fB\fIN\fR\fR
.RS 4
This option will cause apt\-listchanges to show only the latest
\fIN\fR
entries\&. With this option, the only other argument you can pass is the path to a \&.deb file\&.
.RE
.PP
\fB\-\-which={news|changelogs|both}\fR
.RS 4
Cette option permet de choisir entre l\*(Aqaffichage des messages de nouveautés (récupérés dans NEWS\&.Debian et d\*(Aqautres), des journaux de modifications (récupérés dans changelog\&.Debian et d\*(Aqautres) ou des deux\&. Par défaut, uniquement les nouveautés sont affichées\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Affiche une aide courte\&.
.RE
.PP
\fB\-h, \-\-headers\fR
.RS 4
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\*(Aqêtre mis à niveau (s\*(Aqil y en a plus d\*(Aqun ou s\*(Aqil diffère du nom du paquet source)\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Affiche des informations de débogage\&.
.RE
.PP
\fB\-\-profile=\fR\fB\fInom\fR\fR
.RS 4
Sélectionne un profil d\*(Aqoptions\&.
\fInom\fR
correspond à une section dans le fichier
/etc/apt/listchanges\&.conf\&. Les valeurs par défaut sont «\ \&apt\ \&» lors d\*(Aqun appel depuis apt et «\ \&cmdline\ \&» sinon\&.
.RE
.PP
\fB\-\-log=\fR\fB\fIfile\fR\fR
.RS 4
Select the file appended to by the log frontend\&. The default is
/var/log/apt/listchanges\&.log\&. The filter command option can be used to modify the output before it is appended to the log file\&. Please ensure that you setup log rotation for this file\&.
.RE
.PP
\fB\-\-filter=\fR\fB\fIcommand\fR\fR
.RS 4
Select the command used to filter output before it is appended to the log file by the log frontend\&. stdin will receive the
\fBapt\-listchanges\fR
output and stdout will be appended to the log file\&. Separate arguments with spaces and quote arguments containing spaces\&. The command will not be run using the shell unless the shell is included in the command:
\fBsh \-c \*(Aqdate ; cat\*(Aq\fR
.RE
.PP
\fB\-\-reverse\fR
.RS 4
Montre les entrées du journal des modifications en ordre inverse\&.
.RE
.PP
\fB\-\-ignore\-apt\-assume\fR, \fB\-\-ignore\-debian\-frontend\fR
.RS 4
Désactive l\*(Aqobligation d\*(Aqutiliser une interface non\-interactive dans certains des cas décrits dans la section «\ \&AUTOMATIC FRONTEND OVERRIDE\ \&» ci\-dessous\&.
.RE
.PP
\fB\-\-titled\fR, \fB\-\-untitled\fR
.RS 4
Enable or disable the title at the beginning of the output\&.
.RE
.PP
\fB\-\-select\-frontend\fR
.RS 4
Choisit l\*(Aqinterface de façon interactive\&. Cette option est essentiellement destinée à des tests, veuillez ne pas l\*(Aqutiliser\&.
.RE
.SH "AUTOMATIC FRONTEND OVERRIDE"
.PP
Pour une meilleure intégration aux outils de gestion de paquets existants,
\fBapt\-listchanges\fR
essaye de détecter si les mises à niveau de paquets se font de manière non\-interactive, et bascule automatiquement son interface à «\ \&text\ \&» si l\*(Aq\fIune\fR
des conditions suivantes est satisfaite\ \&:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
la sortie standard n\*(Aqest pas connectée à un terminal\ \&;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
l\*(Aqoption
\fB\-\-quiet\fR
(\fB\-q\fR) est passée à
\fBapt-get\fR(8)
(ou
\fBaptitude\fR(8))\ \&; notez néanmoins que si l\*(Aqoption est utilisée plus d\*(Aqune fois, apt\-listchanges bascule l\*(Aqinterface à «\ \&mail\ \&»\ \&;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
l\*(Aqoption
\fB\-\-assume\-yes\fR
(\fB\-y\fR) est passée à
\fBapt-get\fR(8)\ \&;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
la variable d\*(Aqenvironnement
\fBDEBIAN_FRONTEND\fR
est définie à «\ \&noninteractive\ \&» et
\fBAPT_LISTCHANGES_FRONTEND\fR
n\*(Aqest pas définie\&.
.RE
.PP
Pour des raisons de rétrocompatibilité, les deux dernières vérifications peuvent être désactivées par l\*(Aqentrée «\ \&ignore_apt_assume=true\ \&» ou par l\*(Aqentrée «\ \&ignore_debian_frontend=true\ \&» du fichier de configuration (voir «\ \&FICHIER DE CONFIGURATION\ \&» plus bas), ou en utilisant les options en ligne de commande\ \&:
\fB\-\-ignore\-apt\-assume\fR
ou
\fB\-\-ignore\-debian\-frontend\fR\&.
.PP
Veuillez noter aussi que l\*(Aqinterface «\ \&mail\ \&» est déjà non\-interactive, aussi, elle ne bascule jamais vers l\*(Aqinterface «\ \&text\ \&»\&.
.PP
En complément,
\fBapt\-listchanges\fR
surcharge les interfaces basées sur X11(«\ \&gtk\ \&», «\ \&xterm\-pager\ \&», «\ \&xterm\-browser\ \&») avec «\ \&pager\ \&» (ou «\ \&browser\ \&» dans le cas de «\ \&xterm\-browser\ \&») lorsque la variable d\*(Aqenvironnement
\fBDISPLAY\fR
n\*(Aqest pas définie\&.
.PP
Please note that these silent frontends are not subject to the overrides: syslog log
.SH "FICHIER DE CONFIGURATION"
.PP
\fBapt\-listchanges\fR
reads its configuration from the
/etc/apt/listchanges\&.conf\&. The file consists of
\fIsections\fR
with names enclosed in the square brackets\&. Each section should contain lines in the
\fIkey\fR=\fIvalue\fR
format\&. Lines starting with the "#" sign are treated as comments and ignored\&. Files named
\fIname\fR\&.conf
in the
/etc/apt/listchanges\&.conf\&.d
directory are also read in the same way and override values set in the main configuration file\&.
.PP
\fISection\fR
est un nom de profil qui peut être utilisé comme paramètre de l\*(Aqoption
\fB\-\-profile\fR\&.
.PP
La configuration de la section «\ \&apt\ \&» peut être gérée par
\fBdebconf\fR(7), et la plupart des réglages peuvent ici être modifiés à l\*(Aqaide de la commande
\fBdpkg\-reconfigure apt\-listchanges\fR\&.
.PP
\fIClé\fR
est le nom d\*(Aqune option en ligne de commande (sauf pour
\fB\-\-apt\fR,
\fB\-\-profile\fR
et
\fB\-\-help\fR) sans le tiret initial et les autres tirets remplacés par des tirets bas, par exemple\ \&: «\ \&email_format\ \&» ou «\ \&save_seen\ \&»\&.
.PP
\fIvaleur\fR
représente la valeur de l\*(Aqoption correspondante\&. Pour les options en ligne de commande qui ne prennent pas d\*(Aqargument, comme «\ \&confirm\ \&» ou «\ \&headers\ \&», la
\fIvaleur\fR
peut être définie à «\ \&1\ \&», «\ \&yes\ \&», «\ \&true\ \&» ou «\ \&on\ \&» pour activer l\*(Aqoption , ou à «\ \&0\ \&», «\ \&no\ \&», «\ \&false\ \&» ou «\ \&off\ \&» pour la désactiver\&.
.PP
En plus,
\fIclé\fR
peut être un des mots\-clés suivants\ \&: «\ \&browser\ \&», «\ \&pager\ \&» ou «\ \&xterm\ \&»\&. La
\fIvaleur\fR
de ces entrées de configuration peut être le nom d\*(Aqune commande appropriée, éventuellement suivie par ses arguments, par exemple\ \&: «\ \&pager=less \-R\ \&»\&.
.PP
\fBExemple 1. Exemple de fichier de configuration\fR
.sp
.if n \{\
.RS 4
.\}
.nf
[cmdline]
frontend=pager

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

[perso]
frontend=browser
browser=mozilla
.fi
.if n \{\
.RE
.\}
.PP
Le fichier de configuration précédent indique que dans le mode ligne de commande, l\*(Aqinterface par défaut doit être «\ \&pager\ \&»\&. Dans le mode apt, l\*(Aqinterface sera par défaut xterm\-pager, une copie des journaux (s\*(Aqil y en a) devra être envoyée au superutilisateur («\ \&root\ \&») et apt\-listchanges demandera une confirmation\&. Si apt\-listchanges est appelé avec \-\-profile=custom, l\*(Aqinterface browser sera utilisée et lancera mozilla\&.
.SH "ENVIRONNEMENT"
.PP
APT_LISTCHANGES_FRONTEND
.RS 4
Interface à utiliser\&.
.RE
.PP
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
.RS 4
La première valeur rencontrée des variables ci\-dessus sera utilisée comme nom de l\*(Aqutilisateur vers lequel basculer lors de l\*(Aqexécution de commandes générées par les interfaces «\ \&browser\ \&», «\ \&pager\ \&» ou «\ \&xterm\ \&» si c\*(Aqest un utilisateur privilégié qui a lancé
\fBapt\-listchanges\fR\&.
.RE
.PP
DEBIAN_FRONTEND
.RS 4
Si le réglage est «\ \&noninteractive\ \&», l\*(Aqoption peut forcer
\fBapt\-listchanges\fR
à utiliser une interface non interactive, voir la section «\ \&AUTOMATIC FRONTEND OVERRIDE\ \&» pour plus de détails\&.
.RE
.PP
BROWSER
.RS 4
Utilisé par l\*(Aqinterface browser, elle devrait contenir une commande qui attend l\*(AqURL d\*(Aqun fichier HTML à afficher\&.
.RE
.PP
PAGER
.RS 4
Utilisé par l\*(Aqinterface pager\&.
.RE
.PP
APT_HOOK_INFO_FD
.RS 4
Descripteur de fichier pour lire les noms de paquet dans le mode
\fB\-\-apt\fR\&. (Apt est censé définir cette variable à un numéro de descripteur de fichier correct)\&.
.RE
.SH "FICHIER"
.PP
/etc/apt/listchanges\&.conf
.RS 4
Fichier de configuration\&.
.RE
.PP
/etc/apt/listchanges\&.conf\&.d/*\&.conf
.RS 4
Configuration file override files\&.
.RE
.PP
/etc/apt/apt\&.conf\&.d/20listchanges
.RS 4
Fichier utilisé pour inscrire apt\-listchanges dans le système apt\&.
.RE
.PP
/var/lib/apt/listchanges\&.db
.RS 4
Base de données des déjà\-vus\&.
.RE
.SH "AUTEUR"
.PP
apt\-listchanges a été écrit par Matt Zimmerman <mdz@debian\&.org>
.PP
Le responsable actuel est Robert Luberda <robert@debian\&.org>
.SH "VOIR AUSSI"
.PP
\fBsensible-pager\fR(1),
\fBsensible-browser\fR(1),
\fBapt-get\fR(8),
\fBaptitude\fR(8)
.SH "TRADUCTEUR"
.PP
Traduction d\*(AqOlivier Trichet <olivier\&.trichet@centrale\-lille\&.net>, août 2004\&. Mis à jour en 2017 par Jean\-Pierre Giraud <jean\-pierregiraud@neuf\&.fr> et l\*(Aqéquipe de traduction francophone de debian <debian\-l10n\-french@lists\&.debian\&.org>