noble (1) apt-listchanges.1.gz
NOM
apt-listchanges - Affiche les nouvelles entrées du journal des modifications des paquets de l'archive
Debian
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.
Veuillez noter que dans l'installation par défaut si apt-listchanges est exécuté en tant que greffon
d'APT durant les mises à niveau, il affiche seulement les entrées de NEWS.Debian. Ce comportement peut
être modifié avec l'option --which.
Si les entrées du journal des modifications sont affichées et que le paquet ne fournit pas de fichier
changelog[.Debian], apt-listchanges appelle la commande apt-get changelog pour télécharger le journal des
modifications à partir du réseau. Ce comportement peut être désactivé avec l'option --no-network.
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
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 --reverse option can
be used to alter this order.
OPTIONS
apt-listchanges fournit les options suivantes pour contrôler son comportement. Pour la plupart d'entre
elles, il existe des entrées équivalentes dans le fichier de configuration, voir ci-dessous le « FICHIER
DE CONFIGURATION » pour plus de détails.
--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
Utilise la commande sensible-pager(1) pour afficher la sortie. La variable d'environnement PAGER
est utilisée pour choisir votre pageur favori. L'option « pager » peut être spécifiée dans le
fichier de configuration pour sélectionner un pageur spécifique à utiliser avec apt-listchanges.
browser
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 sensible-browser(1)
qui examine la variable d'environnement BROWSER pour choisir votre navigateur favori. L'option
« browser » peut être spécifiée dans le fichier de configuration pour sélectionner un navigateur
spécifique à utiliser avec 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.
syslog
Dumps output to syslog. Disabling the titled option is recommended.
log
Appends output to a log file, with an optional filter process. Disabling the titled option is
recommended.
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.
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'applique pas actuellement à l'interface « pager ». Voir aussi les « VARIABLES
D'ENVIRONNEMENT » ci-dessous.
--email-address=adresse
Affichage du journal des modifications et envoi d'une copie à l'adresse spécifiée. Pour ne recevoir
les journaux de modifications que par courriel, utiliser cette option avec la pseudo-interface
« mail ».
--email-format={text|html}
Si l'envoi de copies de courriel est autorisée (voir --email-address 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.
-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.
-c, --no-network
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), apt-listchanges, par défaut, exécute apt-get changelog pour télécharger
les journaux de modifications des serveurs réseau habituellement fournis par la distribution de votre
système d'exploitation. Cette option désactivera ce comportement, ce qui peut être utile, par exemple
pour des machines derrière un pare-feu.
--save-seen=fichier
Cette option demande à apt-listchanges de garder une trace de la dernière version d'un paquet pour
laquelle le journal a été affiché 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
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'indiquer avec l'option --save-seen ou passez l'option --profile=apt pour qu'il soit lu à partir du
fichier de configuration.
--since=version
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'un fichier .deb.
--latest=N
This option will cause apt-listchanges to show only the latest N entries. 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 à niveau (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.
--log=file
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.
--filter=command
Select the command used to filter output before it is appended to the log file by the log frontend.
stdin will receive the apt-listchanges 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: sh -c 'date ; cat'
--reverse
Montre les entrées du journal des modifications en ordre inverse.
--ignore-apt-assume, --ignore-debian-frontend
Désactive l'obligation d'utiliser une interface non-interactive dans certains des cas décrits dans la
section « AUTOMATIC FRONTEND OVERRIDE » ci-dessous.
--titled, --untitled
Enable or disable the title at the beginning of the output.
--select-frontend
Choisit l'interface de façon interactive. Cette option est essentiellement destinée à des tests,
veuillez ne pas l'utiliser.
AUTOMATIC FRONTEND OVERRIDE
Pour une meilleure intégration aux outils de gestion de paquets existants, apt-listchanges 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'une des conditions suivantes est satisfaite :
• la sortie standard n'est pas connectée à un terminal ;
• l'option --quiet (-q) est passée à apt-get(8) (ou aptitude(8)) ; notez néanmoins que si l'option est
utilisée plus d'une fois, apt-listchanges bascule l'interface à « mail » ;
• l'option --assume-yes (-y) est passée à apt-get(8) ;
• la variable d'environnement DEBIAN_FRONTEND est définie à « noninteractive » et
APT_LISTCHANGES_FRONTEND n'est pas définie.
Pour des raisons de rétrocompatibilité, les deux dernières vérifications peuvent être désactivées par
l'entrée « ignore_apt_assume=true » ou par l'entrée « ignore_debian_frontend=true » du fichier de
configuration (voir « FICHIER DE CONFIGURATION » plus bas), ou en utilisant les options en ligne de
commande : --ignore-apt-assume ou --ignore-debian-frontend.
Veuillez noter aussi que l'interface « mail » est déjà non-interactive, aussi, elle ne bascule jamais
vers l'interface « text ».
En complément, apt-listchanges 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'environnement DISPLAY n'est pas définie.
Please note that these silent frontends are not subject to the overrides: syslog log
FICHIER DE CONFIGURATION
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. Files named name.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.
Section est un nom de profil qui peut être utilisé comme paramètre de l'option --profile.
La configuration de la section « apt » peut être gérée par debconf(7), et la plupart des réglages peuvent
ici être modifiés à l'aide de la commande dpkg-reconfigure apt-listchanges.
Clé est le nom d'une option en ligne de commande (sauf pour --apt, --profile et --help) sans le tiret
initial et les autres tirets remplacés par des tirets bas, par exemple : « email_format » ou
« save_seen ».
valeur représente la valeur de l'option correspondante. Pour les options en ligne de commande qui ne
prennent pas d'argument, comme « confirm » ou « headers », la valeur peut être définie à « 1 », « yes »,
« true » ou « on » pour activer l'option , ou à « 0 », « no », « false » ou « off » pour la désactiver.
En plus, clé peut être un des mots-clés suivants : « browser », « pager » ou « xterm ». La valeur de ces
entrées de configuration peut être le nom d'une commande appropriée, éventuellement suivie par ses
arguments, par exemple : « pager=less -R ».
Exemple 1. 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 superutilisateur (« root ») et apt-listchanges demandera une
confirmation. Si apt-listchanges est appelé avec --profile=custom, l'interface browser sera utilisée et
lancera mozilla.
ENVIRONNEMENT
APT_LISTCHANGES_FRONTEND
Interface à utiliser.
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
La première valeur rencontrée des variables ci-dessus sera utilisée comme nom de l'utilisateur vers
lequel basculer lors de l'exécution de commandes générées par les interfaces « browser », « pager »
ou « xterm » si c'est un utilisateur privilégié qui a lancé apt-listchanges.
DEBIAN_FRONTEND
Si le réglage est « noninteractive », l'option peut forcer apt-listchanges à utiliser une interface
non interactive, voir la section « AUTOMATIC FRONTEND OVERRIDE » pour plus de détails.
BROWSER
Utilisé par l'interface browser, elle devrait contenir une commande qui attend l'URL d'un fichier
HTML à afficher.
PAGER
Utilisé par l'interface pager.
APT_HOOK_INFO_FD
Descripteur de fichier pour lire les noms de paquet dans le mode --apt. (Apt est censé définir cette
variable à un numéro de descripteur de fichier correct).
FICHIER
/etc/apt/listchanges.conf
Fichier de configuration.
/etc/apt/listchanges.conf.d/*.conf
Configuration file override files.
/etc/apt/apt.conf.d/20listchanges
Fichier utilisé pour inscrire apt-listchanges dans le système apt.
/var/lib/apt/listchanges.db
Base de données des déjà-vus.
AUTEUR
apt-listchanges a été écrit par Matt Zimmerman <mdz@debian.org> Le responsable actuel est Robert Luberda <robert@debian.org>
VOIR AUSSI
sensible-pager(1), sensible-browser(1), apt-get(8), aptitude(8)
TRADUCTEUR
Traduction d'Olivier Trichet <olivier.trichet@centrale-lille.net>, août 2004. Mis à jour en 2017 par Jean-Pierre Giraud <jean-pierregiraud@neuf.fr> et l'équipe de traduction francophone de debian <debian-l10n-french@lists.debian.org>