SYNOPSIS

apt-listchanges [options ... ] {--apt | paquet.deb ... }

DESCRIPTION

apt-listchanges 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.
 

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/paquet, de l'archive d'un paquet Debian.
 

Given a set of filenames as arguments (or read from apt when using --apt), apt-listchanges 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 than by the package name. Changes within each package group are displayed in the order of their apperance in the changelog files, i.e. starting from the latest to the oldest; the --reverse option can be used to alter this order.
 

OPTIONS

--apt

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.
 

-v, --verbose

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.
 

-f, --frontend

Sélectionne l'interface à utiliser pour afficher l'information à l'utilisateur. Les interfaces disponibles actuellement sont :
 

pager

Uses sensible-pager(1) command to display output. The command uses PAGER environment variable to choose your favourite pager. The "pager" option may be specified in the configuration file to select a specific pager for use with apt-listchanges.
 

browser

Displays an HTML-formatted changelog with hyperlinks for bugs and email addresses using the sensible-browser(1) command that examines BROWSER environment variable to choose your favourite browser. The "browser" option may be specified in the configuration file to select a specific browser for use with apt-listchanges.
 

xterm-pager

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.
 

xterm-browser

La conjonction des options xterm-pager et browser. Cela convient uniquement aux navigateurs en mode texte.
 

text

Affiche, sans pause, le résultat sur la sortie standard.
 

mail

Envoie un courriel à l'adresse donnée grâce à --email-address sans afficher les journaux de modifications.
 

gtk

Ouvre une fenêtre pour afficher les modifications. Il est nécessaire que python3-gi soit installé.
 

none

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.
 

Please note that apt-listchanges will try to switch to an unprivileged user before spawning commands in "browser", "xterm-browser", and "xterm-pager" frontends. However this currently does not apply to the "pager" frontend. See also "ENVIRONMENT VARIABLES" below.
 

--email-address=adresse

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 ».
 

--email-format={text|html}

If sending mail copies is enabled (see --email-address above), this option selects whether the mail should be sent as an old good plain text data (which is the default behavior), or as html data with clickable links, which might be more convenient for people using graphical mail clients.
 

-c, --confirm

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.
 

-a, --show-all

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.
 

--save-seen=fichier

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é.
 

--dump-seen

Display the contents of the seen database to standard output as a list of lines consising of source package name and its latest seen version, separated by space. This option requires the path to the seen database to be known: please either specify it using --save-seen option or pass --profile=apt option to have it read from the configuration file.
 

--since=version

This option will cause apt-listchanges to show the entries later than the specified version. With this option, the only other argument you can pass is the path to a .deb file.
 

--which={news|changelogs|both}

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, uniquement les nouveautés sont affichées.
 

--help

Affiche une aide courte.
 

-h, --headers

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).
 

--debug

Affiche des informations de débogage.
 

--profile=nom

Sélectionne un profil d'options. nom correspond à une section dans le fichier /etc/apt/listchanges.conf. Les valeurs par défaut sont « apt » lors d'un appel depuis apt et « cmdline » sinon.
 

--reverse

Show the changelog entries in reverse order.
 

--ignore-apt-assume, --ignore-debian-frontend

Disable forcing non-interactive frontend in some of the cases described in the "AUTOMATIC FRONTEND OVERRIDE" section below.
 

--select-frontend

Choose frontend interactively. This option is mainly for testing purposes, please do not use it.
 

AUTOMATIC FRONTEND OVERRIDE

For a better integration with existing package management tools, apt-listchanges tries to detect if package upgrades are done in a non-interactive way, and automatically switches its frontend to 'text' when any of the following conditions is satisfied:
 

•

the standard output is not connected to terminal;
 

•

the --quiet (-q) option is given to apt-get(8) (or aptitude(8)); note however that when the option is used more than once, apt-listchanges switches the frontend to 'mail';
 

•

the --assume-yes (-y) option is given to apt-get(8));
 

•

the DEBIAN_FRONTEND environment variable is set to "noninteractive", and APT_LISTCHANGES_FRONTED is not set.
 

For backward compatibility purposes the last two of the above checks can be disabled either with "ignore_apt_assume=true" or "ignore_debian_frontend=true" configuration file entries (see "CONFIGURATION FILE" below) or by using the command line options: --ignore-apt-assume or --ignore-debian-frontend.
 

Please also note that the "mail" frontend is already non-interactive one, so it is never switched to the "text" frontend.
 

Additionally apt-listchanges overrides X11-based frontends ("gtk", "xterm-pager", "xterm-browser") with "pager" (or "browser" in case of "xterm-browser") when the environment variable DISPLAY is not set.
 

CONFIGURATION FILE

apt-listchanges reads its configuration from the /etc/apt/listchanges.conf. The file consists of sections with names enclosed in the square brackets. Each section should contain lines in the key=value format. Lines starting with the "#" sign are treated as comments and ignored.
 

Section is a name of profile that can be used as parameter of the --profile option.
 

Key is a name of some command-line option (except for --apt, --profile, --help) with the initial hyphens removed, and the remaining hyphens translated to underscores, for example: "email_format" or "save_seen".
 

Value represents the value of the corresponding option. For command-line options that do not take argument, like "confirm" or "header", the value should be set either to "1", "yes", "true", and "on" in order to enable the option, or to "0", "no", "false", and "off" to disable it.
 

Additionally key can be one of the following keywords: "browser", "pager" or "xterm". The value of such configuration entry should be the name of an appropriate command, eventually followed by its arguments, for example: "pager=less -R".
 

Exemple de fichier de configuration

[cmdline] 
frontend=pager 
 
[apt] 
frontend=xterm-pager 
email_address=root 
confirm=1 
 
[perso] 
frontend=browser 
browser=mozilla 
 

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.
 

FICHIER

/etc/apt/listchanges.conf

Configuration file
 

/etc/apt/apt.conf.d/20listchanges

File used for registering apt-listchanges into apt system
 

/var/lib/apt/listchanges.db

Base de données des déja-vus
 

AUTEUR

apt-listchanges a été écrit par Matt Zimmerman <[email protected]>
 

TRADUCTEUR

Traduction d'Olivier Trichet <[email protected]>, août 2004