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