'\" t .\" Title: apt-listchanges .\" Author: Matt Zimmerman .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 2017-07-08 .\" Manual: Debian .\" Source: apt-listchanges .\" Language: French .\" .TH "APT\-LISTCHANGES" "1" "2017\-07\-08" "apt-listchanges" "Debian" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NOM" apt-listchanges \- Affiche les nouvelles entrées du journal des modifications des paquets de l\*(Aqarchive Debian .SH "SYNOPSIS" .HP \w'\fBapt\-listchanges\fR\ 'u \fBapt\-listchanges\fR [[\fIoptions\fR...]] {[\fB\-\-apt\fR] | [\fIpaquet\&.deb\fR...]} .SH "DESCRIPTION" .PP \fBapt\-listchanges\fR est un outil qui affiche ce qui a changé dans la nouvelle version d\*(Aqun paquet Debian par rapport à la version actuellement installée sur le système\&. .PP 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/\fIpaquet\fR, de l\*(Aqarchive d\*(Aqun paquet Debian\&. .PP Veuillez noter que dans l\*(Aqinstallation par défaut si \fBapt\-listchanges\fR est exécuté en tant que greffon d\*(AqAPT durant les mises à niveau, il affiche seulement les entrées de NEWS\&.Debian\&. Ce comportement peut être modifié avec l\*(Aqoption \fB\-\-which\fR\&. .PP Si les entrées du journal des modifications sont affichées et que le \fIpaquet\fR ne fournit pas de fichier changelog[\&.Debian], \fBapt\-listchanges\fR appelle la commande \fBapt\-get changelog\fR pour télécharger le journal des modifications à partir du réseau\&. Ce comportement peut être désactivé avec l\*(Aqoption \fB\-\-no\-network\fR\&. .PP Avec des noms de fichiers en argument (ils peuvent être lus depuis apt si l\*(Aqoption \fB\-\-apt\fR est utilisée), \fBapt\-listchanges\fR 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\*(Aqurgence des modifications et ensuite par nom de paquet\&. Les modifications sont affichées dans chaque groupe dans l\*(Aqordre de leur apparition dans les fichiers de journal des modifications, c\*(Aqest\-à\-dire de la plus récente à la plus ancienne\ \&; l\*(Aqoption \fB\-\-reverse\fR peut être utilisée pour changer cet ordre\&. .SH "OPTIONS" .PP \fBapt\-listchanges\fR fournit les options suivantes pour contrôler son comportement\&. Pour la plupart d\*(Aqentre elles, il existe des entrées équivalentes dans le fichier de configuration, voir ci\-dessous le «\ \&FICHIER DE CONFIGURATION\ \&» pour plus de détails\&. .PP \fB\-\-apt\fR .RS 4 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\*(Aqapt\&. .RE .PP \fB\-v, \-\-verbose\fR .RS 4 Affiche des informations additionnelles (généralement non désirées)\&. Par exemple, cela affiche un message lorsqu\*(Aqun paquet d\*(Aqune version identique ou inférieure est sur le point d\*(Aqêtre installé, ou lorsqu\*(Aqun paquet est sur le point d\*(Aqêtre installé pour la première fois\&. .RE .PP \fB\-f, \-\-frontend\fR .RS 4 Sélectionne l\*(Aqinterface à utiliser pour afficher l\*(Aqinformation à l\*(Aqutilisateur\&. Les interfaces disponibles actuellement sont\ \&: .PP pager .RS 4 Utilise la commande \fBsensible-pager\fR(1) pour afficher la sortie\&. La variable d\*(Aqenvironnement PAGER est utilisée pour choisir votre pageur favori\&. L\*(Aqoption «\ \&pager\ \&» peut être spécifiée dans le fichier de configuration pour sélectionner un pageur spécifique à utiliser avec apt\-listchanges\&. .RE .PP browser .RS 4 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 \fBsensible-browser\fR(1) qui examine la variable d\*(Aqenvironnement BROWSER pour choisir votre navigateur favori\&. L\*(Aqoption «\ \&browser\ \&» peut être spécifiée dans le fichier de configuration pour sélectionner un navigateur spécifique à utiliser avec apt\-listchanges\&. .RE .PP xterm\-pager .RS 4 Utilise votre pageur favori pour l\*(Aqaffichage, mais le fait dans un xterm en arrière\-plan (en utilisant l\*(Aqalternative 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\*(Aqémulateur de terminal à utiliser avec l\*(Aqoption «\ \&xterm\ \&» du fichier de configuration\&. .RE .PP xterm\-browser .RS 4 La conjonction des options xterm\-pager et browser\&. Cela convient uniquement aux navigateurs en mode texte\&. .RE .PP text .RS 4 Affiche, sans pause, le résultat sur la sortie standard\&. .RE .PP mail .RS 4 Envoie un courriel à l\*(Aqadresse donnée grâce à \-\-email\-address sans afficher les journaux de modifications\&. .RE .PP gtk .RS 4 Ouvre une fenêtre pour afficher les modifications\&. Il est nécessaire que python3\-gi soit installé\&. .RE .PP none .RS 4 Ne fait rien\&. Cela peut être utilisé pour éviter qu\*(Aqapt\-listchanges ne se lance alors qu\*(Aqil est configuré pour se lancer automatiquement depuis apt\&. .RE .sp 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\*(Aqapplique pas actuellement à l\*(Aqinterface «\ \&pager\ \&»\&. Voir aussi les «\ \&VARIABLES D\*(AqENVIRONNEMENT\ \&» ci\-dessous\&. .RE .PP \fB\-\-email\-address=\fR\fB\fIadresse\fR\fR .RS 4 Affichage du journal des modifications et envoi d\*(Aqune copie à l\*(Aqadresse spécifiée\&. Pour ne recevoir les journaux de modifications que par courriel, utiliser cette option avec la pseudo\-interface «\ \&mail\ \&»\&. .RE .PP \fB\-\-email\-format={text|html}\fR .RS 4 Si l\*(Aqenvoi de copies de courriel est autorisée (voir \fB\-\-email\-address\fR 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\&. .RE .PP \fB\-c, \-\-confirm\fR .RS 4 Une fois que les journaux de modifications ont été affichés, demande à l\*(Aqutilisateur s\*(Aqil veut continuer ou interrompre l\*(Aqinstallation\&. Si l\*(Aqutilisateur choisit d\*(Aqinterrompre, une valeur de sortie non nulle est renvoyée et apt abandonne\&. .RE .PP \fB\-a, \-\-show\-all\fR .RS 4 Au lieu d\*(Aqafficher uniquement les entrées des journaux plus récentes que la version du paquet en cours d\*(Aqinstallation, affiche la totalité du journal des modifications du paquet\&. C\*(Aqest utile pour voir la totalité du journal contenu dans un paquet \&.deb avant d\*(Aqextraire ce dernier\&. .RE .PP \fB\-c, \-\-no\-network\fR .RS 4 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), \fBapt\-listchanges\fR, par défaut, exécute \fBapt\-get changelog\fR pour télécharger les journaux de modifications des serveurs réseau habituellement fournis par la distribution de votre système d\*(Aqexploitation\&. Cette option désactivera ce comportement, ce qui peut être utile, par exemple pour des machines derrière un pare\-feu\&. .RE .PP \fB\-\-save\-seen=\fR\fB\fIfichier\fR\fR .RS 4 Cette option demande à apt\-listchanges de garder une trace de la dernière version d\*(Aqun paquet pour laquelle le journal a été affiché afin d\*(Aqé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é\&. .RE .PP \fB\-\-dump\-seen\fR .RS 4 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\*(Aqindiquer avec l\*(Aqoption \fB\-\-save\-seen\fR ou passez l\*(Aqoption \fB\-\-profile=apt\fR pour qu\*(Aqil soit lu à partir du fichier de configuration\&. .RE .PP \fB\-\-since=\fR\fB\fIversion\fR\fR .RS 4 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\*(Aqun fichier \&.deb\&. .RE .PP \fB\-\-which={news|changelogs|both}\fR .RS 4 Cette option permet de choisir entre l\*(Aqaffichage des messages de nouveautés (récupérés dans NEWS\&.Debian et d\*(Aqautres), des journaux de modifications (récupérés dans changelog\&.Debian et d\*(Aqautres) ou des deux\&. Par défaut, uniquement les nouveautés sont affichées\&. .RE .PP \fB\-\-help\fR .RS 4 Affiche une aide courte\&. .RE .PP \fB\-h, \-\-headers\fR .RS 4 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\*(Aqêtre mis à niveau (s\*(Aqil y en a plus d\*(Aqun ou s\*(Aqil diffère du nom du paquet source)\&. .RE .PP \fB\-\-debug\fR .RS 4 Affiche des informations de débogage\&. .RE .PP \fB\-\-profile=\fR\fB\fInom\fR\fR .RS 4 Sélectionne un profil d\*(Aqoptions\&. \fInom\fR correspond à une section dans le fichier /etc/apt/listchanges\&.conf\&. Les valeurs par défaut sont «\ \&apt\ \&» lors d\*(Aqun appel depuis apt et «\ \&cmdline\ \&» sinon\&. .RE .PP \fB\-\-reverse\fR .RS 4 Montre les entrées du journal des modifications en ordre inverse\&. .RE .PP \fB\-\-ignore\-apt\-assume\fR, \fB\-\-ignore\-debian\-frontend\fR .RS 4 Désactive l\*(Aqobligation d\*(Aqutiliser une interface non\-interactive dans certains des cas décrits dans la section «\ \&AUTOMATIC FRONTEND OVERRIDE\ \&» ci\-dessous\&. .RE .PP \fB\-\-select\-frontend\fR .RS 4 Choisit l\*(Aqinterface de façon interactive\&. Cette option est essentiellement destinée à des tests, veuillez ne pas l\*(Aqutiliser\&. .RE .SH "AUTOMATIC FRONTEND OVERRIDE" .PP Pour une meilleure intégration aux outils de gestion de paquets existants, \fBapt\-listchanges\fR 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\*(Aq\fIune\fR des conditions suivantes est satisfaite\ \&: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} la sortie standard n\*(Aqest pas connectée à un terminal\ \&; .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} l\*(Aqoption \fB\-\-quiet\fR (\fB\-q\fR) est passée à \fBapt-get\fR(8) (ou \fBaptitude\fR(8))\ \&; notez néanmoins que si l\*(Aqoption est utilisée plus d\*(Aqune fois, apt\-listchanges bascule l\*(Aqinterface à «\ \&mail\ \&»\ \&; .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} l\*(Aqoption \fB\-\-assume\-yes\fR (\fB\-y\fR) est passée à \fBapt-get\fR(8)\ \&; .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} la variable d\*(Aqenvironnement \fBDEBIAN_FRONTEND\fR est définie à «\ \&noninteractive\ \&» et \fBAPT_LISTCHANGES_FRONTEND\fR n\*(Aqest pas définie\&. .RE .PP Pour des raisons de rétrocompatibilité, les deux dernières vérifications peuvent être désactivées par l\*(Aqentrée «\ \&ignore_apt_assume=true\ \&» ou par l\*(Aqentrée «\ \&ignore_debian_frontend=true\ \&» du fichier de configuration (voir «\ \&FICHIER DE CONFIGURATION\ \&» plus bas), ou en utilisant les options en ligne de commande\ \&: \fB\-\-ignore\-apt\-assume\fR ou \fB\-\-ignore\-debian\-frontend\fR\&. .PP Veuillez noter aussi que l\*(Aqinterface «\ \&mail\ \&» est déjà non\-interactive, aussi, elle ne bascule jamais vers l\*(Aqinterface «\ \&text\ \&»\&. .PP En complément, \fBapt\-listchanges\fR surcharge les interfaces basées sur X11(«\ \>k\ \&», «\ \&xterm\-pager\ \&», «\ \&xterm\-browser\ \&») avec «\ \&pager\ \&» (ou «\ \&browser\ \&» dans le cas de «\ \&xterm\-browser\ \&») lorsque la variable d\*(Aqenvironnement \fBDISPLAY\fR n\*(Aqest pas définie\&. .SH "FICHIER DE CONFIGURATION" .PP \fBapt\-listchanges\fR lit sa configuration à partir du fichier /etc/apt/listchanges\&.conf\&. Le fichier est composé de \fIsections\fR dont le nom est entre crochets\&. Chaque section devrait avoir des lignes au format \fIclé\fR=\fIvaleur\fR\&. Les lignes qui commencent par le caractère «\ \&#\ \&» sont considérées comme des commentaires et ignorées\&. .PP \fISection\fR est un nom de profil qui peut être utilisé comme paramètre de l\*(Aqoption \fB\-\-profile\fR\&. .PP La configuration de la section «\ \&apt\ \&» peut être gérée par \fBdebconf\fR(7), et la plupart des réglages peuvent ici être modifiés à l\*(Aqaide de la commande \fBdpkg\-reconfigure apt\-listchanges\fR\&. .PP \fIClé\fR est le nom d\*(Aqune option en ligne de commande (sauf pour \fB\-\-apt\fR, \fB\-\-profile\fR et \fB\-\-help\fR) sans le tiret initial et les autres tirets remplacés par des tirets bas, par exemple\ \&: «\ \&email_format\ \&» ou «\ \&save_seen\ \&»\&. .PP \fIvaleur\fR représente la valeur de l\*(Aqoption correspondante\&. Pour les options en ligne de commande qui ne prennent pas d\*(Aqargument, comme «\ \&confirm\ \&» ou «\ \&headers\ \&», la \fIvaleur\fR peut être définie à «\ \&1\ \&», «\ \&yes\ \&», «\ \&true\ \&» ou «\ \&on\ \&» pour activer l\*(Aqoption , ou à «\ \&0\ \&», «\ \&no\ \&», «\ \&false\ \&» ou «\ \&off\ \&» pour la désactiver\&. .PP En plus, \fIclé\fR peut être un des mots\-clés suivants\ \&: «\ \&browser\ \&», «\ \&pager\ \&» ou «\ \&xterm\ \&»\&. La \fIvaleur\fR de ces entrées de configuration peut être le nom d\*(Aqune commande appropriée, éventuellement suivie par ses arguments, par exemple\ \&: «\ \&pager=less \-R\ \&»\&. .PP \fBExemple 1. Exemple de fichier de configuration\fR .sp .if n \{\ .RS 4 .\} .nf [cmdline] frontend=pager [apt] frontend=xterm\-pager email_address=root confirm=1 [perso] frontend=browser browser=mozilla .fi .if n \{\ .RE .\} .PP Le fichier de configuration précédent indique que dans le mode ligne de commande, l\*(Aqinterface par défaut doit être «\ \&pager\ \&»\&. Dans le mode apt, l\*(Aqinterface sera par défaut xterm\-pager, une copie des journaux (s\*(Aqil 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\*(Aqinterface browser sera utilisée et lancera mozilla\&. .SH "ENVIRONNEMENT" .PP APT_LISTCHANGES_FRONTEND .RS 4 Interface à utiliser\&. .RE .PP APT_LISTCHANGES_USER, SUDO_USER, USERNAME .RS 4 La première valeur rencontrée des variables ci\-dessus sera utilisée comme nom de l\*(Aqutilisateur vers lequel basculer lors de l\*(Aqexécution de commandes générées par les interfaces «\ \&browser\ \&», «\ \&pager\ \&» ou «\ \&xterm\ \&» si c\*(Aqest un utilisateur privilégié qui a lancé \fBapt\-listchanges\fR\&. .RE .PP DEBIAN_FRONTEND .RS 4 Si le réglage est «\ \&noninteractive\ \&», l\*(Aqoption peut forcer \fBapt\-listchanges\fR à utiliser une interface non interactive, voir la section «\ \&AUTOMATIC FRONTEND OVERRIDE\ \&» pour plus de détails\&. .RE .PP BROWSER .RS 4 Utilisé par l\*(Aqinterface browser, elle devrait contenir une commande qui attend l\*(AqURL d\*(Aqun fichier HTML à afficher\&. .RE .PP PAGER .RS 4 Utilisé par l\*(Aqinterface pager\&. .RE .PP APT_HOOK_INFO_FD .RS 4 Descripteur de fichier pour lire les noms de paquet dans le mode \fB\-\-apt\fR\&. (Apt est censé définir cette variable à un numéro de descripteur de fichier correct)\&. .RE .SH "FICHIER" .PP /etc/apt/listchanges\&.conf .RS 4 Fichier de configuration\&. .RE .PP /etc/apt/apt\&.conf\&.d/20listchanges .RS 4 Fichier utilisé pour inscrire apt\-listchanges dans le système apt\&. .RE .PP /var/lib/apt/listchanges\&.db .RS 4 Base de données des déjà\-vus\&. .RE .SH "AUTEUR" .PP apt\-listchanges a été écrit par Matt Zimmerman .PP Le responsable actuel est Robert Luberda .SH "VOIR AUSSI" .PP \fBsensible-pager\fR(1), \fBsensible-browser\fR(1), \fBapt-get\fR(8), \fBaptitude\fR(8) .SH "TRADUCTEUR" .PP Traduction d\*(AqOlivier Trichet , août 2004\&. Mis à jour en 2017 par Jean\-Pierre Giraud et l\*(Aqéquipe de traduction francophone de debian