APT-LISTCHANGES(1) Debian APT-LISTCHANGES(1)
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.
Avec des noms de fichiers en argument (ils peuvent être lus depuis apt
si l'option --apt est utilisée), apt-listchanges examine les fichiers
(supposés être des archives de paquets Debian) à la recherche des
entrées appropriées et en affiche un résumé groupé par paquet source.
Les groupes sont triés par ordre d'urgence des modifications et ensuite
par nom de paquet. Les modifications sont affichées dans chaque groupe
dans l'ordre de leur apparition dans les fichiers de journal des
modifications, c'est-à-dire de la plus récente à la plus ancienne ;
l'option --reverse peut être utilisée pour changer cet ordre.
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>
apt-listchanges 2017-07-08 APT-LISTCHANGES(1)
Generated by dwww version 1.15 on Sat Jun 29 01:36:15 CEST 2024.