NOME¶
apt-listchanges - Mostra i nuovi elementi dello storico delle
modifiche (changelog) estraendoli da pacchetti Debian
SINOSSI¶
apt-listchanges [[options...]] {[--apt] |
[package.deb...]}
DESCRIZIONE¶
apt-listchanges è uno strumento per vedere quali
modifiche sono state effettuate in una versione più recente di un
pacchetto Debian rispetto alla versione presente sul sistema.
Le modifiche sono raccolte sia da NEWS.Debian che dai file
changelog[.Debian] che solitamente si trovano in
/usr/share/doc/pacchetto degli archivi dei pacchetti Debian.
Given a set of filenames as arguments (or read from apt when using
--apt), apt-listchanges will scan the files (assumed to be
Debian package archives) for the relevant changelog entries, and display
them all in a summary grouped by source package. The groups are sorted by
the urgency of the most urgent change, and than by the package name. Changes
within each package group are displayed in the order of their apperance in
the changelog files, i.e. starting from the latest to the oldest; the
--reverse option can be used to alter this order.
OPZIONI¶
--apt
Legge i nomi dei file da una pipe con un formato speciale
(fornita da apt) anziché dalla riga di comando e usa alcune opzioni nel
file di configurazione specifiche per apt. Nella configurazione di apt deve
essere specificato "version 2" come formato della pipe.
-v, --verbose
Mostra ulteriori (di solito inutili) informazioni. Per
esempio visualizza un messaggio quando sta per essere installata la stessa
versione o una più vecchia di un pacchetto oppure quando un pacchetto
viene installato per la prima volta.
-f, --frontend
Seleziona l'interfaccia da usare per visualizzare le
informazioni all'utente. Attualmente le interfacce sono:
pager
Uses sensible-pager(1) command to display output.
The command uses PAGER environment variable to choose your favourite pager.
The "pager" option may be specified in the configuration file to
select a specific pager for use with apt-listchanges.
browser
Displays an HTML-formatted changelog with hyperlinks for
bugs and email addresses using the sensible-browser(1) command that
examines BROWSER environment variable to choose your favourite browser. The
"browser" option may be specified in the configuration file to
select a specific browser for use with apt-listchanges.
xterm-pager
Usa il paginatore preferito per mostrare l'output
all'interno di un xterm (usando un x-terminal-emulator) separato. Questo
permette di proseguire con l'aggiornamento e di continuare a vedere lo storico
delle modifiche. Si può cambiare l'emulatore di terminale da usare
tramite l'opzione «xterm» nel file di configurazione.
xterm-browser
La combinazione logica di xterm-pager e browser. Adatta
solo ai browser testuali.
text
Trasferisce l'output su stdout, senza pause.
mail
Invia email all'indirizzo specificato con --email-address
e non visualizza lo storico delle modifiche.
gtk
Spawns a gtk window to display the changelogs. Needs
python3-gi to be installed.
none
Non fa nulla. Questa opzione può essere usata per
evitare l'uso di apt-listchanges quando è già configurato per
essere usato automaticamente da apt.
Please note that apt-listchanges will try to switch to an
unprivileged user before spawning commands in "browser",
"xterm-browser", and "xterm-pager" frontends. However
this currently does not apply to the "pager" frontend. See also
"ENVIRONMENT VARIABLES" below.
--email-address=indirizzo
Oltre che ad essere visualizzato, una copia dello storico
delle modifiche è inviata all'indirizzo specificato. Per inviare
solamente lo storico delle modifiche usare questa opzione con l'interfaccia
mail.
--email-format={text|html}
If sending mail copies is enabled (see
--email-address above), this option selects whether the mail should be
sent as an old good plain text data (which is the default behavior), or as
html data with clickable links, which might be more convenient for people
using graphical mail clients.
-c, --confirm
Una volta visualizzato lo storico delle modifiche chiede
all'utente se desidera proseguire. Se l'utente sceglie di non proseguire viene
restituito all'uscita un valore non-nullo e apt verrà interrotto.
-a, --show-all
Anziché tentare di visualizzare gli elementi dello
storico delle modifiche che sono più recenti della versione del
pacchetto attualmente installato mostra tutti gli elementi dello storico delle
modifiche per tutti i pacchetti. Questo permette di vedere l'intero storico
delle modifiche di un .deb prima di estrarlo.
--save-seen=file
Questa opzione forzerà apt-listchanges a tener
traccia dell'ultima versione di un pacchetto per la quale è stato
mostrato lo storico delle modifiche in modo da evitare di mostrare nuovamente
lo stesso storico delle modifiche nelle successive chiamate. Il database viene
memorizzato nel file specificato. Specificare «none» per
disattivare questa funzione.
--dump-seen
Display the contents of the seen database to standard
output as a list of lines consisting of source package name and its latest
seen version, separated by space. This option requires the path to the seen
database to be known: please either specify it using --save-seen option
or pass --profile=apt option to have it read from the configuration
file.
--since=version
This option will cause apt-listchanges to show the
entries later than the specified version. With this option, the only other
argument you can pass is the path to a .deb file.
--which={news|changelogs|both}
Questa opzione seleziona cosa deve essere visualizzato
fra notizie «news» (da NEWS.Debian e altre fonti), storico delle
modifiche «changelogs» (da changelog.Debian e altre fonti) o
entrambi «both». Il comportamento predefinito è mostrare
solo le notizie.
--help
Visualizza informazioni sulla sintassi.
-h, --headers
Queste opzioni causano l'inserimento di una intestazione
prima dello storico delle modifiche di ogni pacchetto che contiene il nome del
pacchetto e il nome dei pacchetti binari che stanno per essere aggiornati (se
più di uno o se diverso dal nome del pacchetto sorgente).
--debug
Visualizza alcune informazioni per il debug.
--profile=nome
Seleziona un profilo. nome corrisponde a una
sezione nel file /etc/apt/listchanges.conf. Il valore predefinito è
“apt” quando avviato da apt e “cmdline” negli
altri casi.
--reverse
Show the changelog entries in reverse order.
--ignore-apt-assume, --ignore-debian-frontend
Disable forcing non-interactive frontend in some of the
cases described in the "AUTOMATIC FRONTEND OVERRIDE" section
below.
--select-frontend
Choose frontend interactively. This option is mainly for
testing purposes, please do not use it.
AUTOMATIC FRONTEND OVERRIDE¶
For a better integration with existing package management tools,
apt-listchanges tries to detect if package upgrades are done in a
non-interactive way, and automatically switches its frontend to 'text' when
any of the following conditions is satisfied:
•the standard output is not connected to
terminal;
•the --quiet (-q) option is given to
apt-get(8) (or aptitude(8)); note however that when the option
is used more than once, apt-listchanges switches the frontend to 'mail';
•the --assume-yes (-y) option is
given to apt-get(8);
•the DEBIAN_FRONTEND environment variable
is set to "noninteractive", and APT_LISTCHANGES_FRONTED is
not set.
For backward compatibility purposes the last two of the above
checks can be disabled either with "ignore_apt_assume=true" or
"ignore_debian_frontend=true" configuration file entries (see
"CONFIGURATION FILE" below) or by using the command line options:
--ignore-apt-assume or --ignore-debian-frontend.
Please also note that the "mail" frontend is already
non-interactive one, so it is never switched to the "text"
frontend.
Additionally apt-listchanges overrides X11-based frontends
("gtk", "xterm-pager", "xterm-browser") with
"pager" (or "browser" in case of
"xterm-browser") when the environment variable DISPLAY is
not set.
CONFIGURATION FILE¶
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.
Section is a name of profile that can be used as parameter
of the --profile option.
Key is a name of some command-line option (except for
--apt, --profile, --help) with the initial hyphens
removed, and the remaining hyphens translated to underscores, for example:
"email_format" or "save_seen".
Value represents the value of the corresponding option. For
command-line options that do not take argument, like "confirm" or
"header", the value should be set either to "1",
"yes", "true", and "on" in order to enable the
option, or to "0", "no", "false", and
"off" to disable it.
Additionally key can be one of the following keywords:
"browser", "pager" or "xterm". The
value of such configuration entry should be the name of an
appropriate command, eventually followed by its arguments, for example:
"pager=less -R".
Esempio 1. File di configurazione di
esempio
[cmdline]
frontend=pager
[apt]
frontend=xterm-pager
email_address=root
confirm=1
[custom]
frontend=browser
browser=mozilla
Il precedente file di configurazione specifica che in
modalità a riga di comando l'interfaccia predefinita deve essere
pager; invece in modalità apt l'interfaccia predefinita è
xterm-pager, una copia dei changelog (se presenti) deve essere inviata a
root e apt-listchanges deve chiedere conferma. Se apt-listchanges è
richiamato con --profile=custom, allora è usata l'interfaccia browser
che utilizza mozilla.
AMBIENTE¶
APT_LISTCHANGES_FRONTEND
Interfaccia da usare.
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
The value of the first existing of the above variables
will be used as the name of user to switch to when running commands spawned by
the "browser", "xterm-browser", and
"xterm-pager" frontends if apt-listchanges is started by a
privileged user.
DEBIAN_FRONTEND
If set to "noninteractive", then it can force
apt-listchanges to use non-interactive frontend, see the
"AUTOMATIC FRONTEND OVERRIDE" section for details.
BROWSER
Usata dall'interfaccia browser, deve essere impostata con
un comando che si aspetti un URL file: di un file HTML da visualizzare.
PAGER
Used by the pager frontend.
APT_HOOK_INFO_FD
File descriptor to read package names from in the
--apt mode. (Apt is expected to set this variable to a proper file
descriptor number).
FILE¶
/etc/apt/listchanges.conf
Configuration file.
/etc/apt/apt.conf.d/20listchanges
File used for registering apt-listchanges into apt
system.
/var/lib/apt/listchanges.db
Database usato per il "già-visto".
AUTORE¶
apt-listchanges è stato scritto da Matt Zimmerman
<mdz@debian.org>
VEDERE ANCHE¶
sensible-pager(1), sensible-browser(1),
apt-get(8), aptitude(8)