NAME
apt-listchanges — Affiche les nouvelles entrées du journal des
modifications des paquets de l’archive Debian
SYNOPSIS
apt-listchanges [options ... ] {--apt | paquet.deb ... }
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.
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é trié par ordre d’urgence.
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 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.
browser 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 BROWSER 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.
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.
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.
--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 ».
-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, --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é.
--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.
ENVIRONNEMENT
APT_LISTCHANGES_FRONTEND
Interface à utiliser.
BROWSER Utilisée par l’interface browser, elle devrait contenir une
commande qui attend l’URL d’un fichier HTML à afficher).
FICHIER
/etc/apt/listchanges.conf
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.
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.
/var/lib/apt/listchanges.db
Base de données des déja-vus
AUTEUR
apt-listchanges a été écrit par Matt Zimmerman <mdz@debian.org>
VOIR AUSSI
apt.conf(5)
TRADUCTEUR
Traduction d’Olivier Trichet <olivier.trichet@centrale-lille.net>, août
2004
apt-listchanges(1)