apt-listchanges

1

apt-listchanges

Affiche les nouvelles entrées du journal des modifications des paquets de l'archive Debian

          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