'\" t
.\"     Title: apt-listchanges
.\"    Author: Matt Zimmerman
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 2016-12-12
.\"    Manual: Debian
.\"    Source: apt-listchanges
.\"  Language: Italian
.\"
.TH "APT\-LISTCHANGES" "1" "2016\-12\-12" "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 "NOME"
apt-listchanges \- Mostra i nuovi elementi dello storico delle modifiche (changelog) estraendoli da pacchetti Debian
.SH "SINOSSI"
.HP \w'\fBapt\-listchanges\fR\ 'u
\fBapt\-listchanges\fR [[\fIoptions\fR...]] {[\fB\-\-apt\fR] | [\fIpackage\&.deb\fR...]}
.SH "DESCRIZIONE"
.PP
\fBapt\-listchanges\fR
è uno strumento per vedere quali modifiche sono state effettuate in una versione più recente di un pacchetto Debian rispetto alla versione presente sul sistema\&.
.PP
Le modifiche sono raccolte sia da NEWS\&.Debian che dai file changelog[\&.Debian]
che solitamente si trovano in
/usr/share/doc/\fIpacchetto\fR
degli archivi dei pacchetti Debian\&.
.PP
Given a set of filenames as arguments (or read from apt when using
\fB\-\-apt\fR),
\fBapt\-listchanges\fR
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
\fB\-\-reverse\fR
option can be used to alter this order\&.
.SH "OPZIONI"
.PP
\fB\-\-apt\fR
.RS 4
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\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
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\&.
.RE
.PP
\fB\-f, \-\-frontend\fR
.RS 4
Seleziona l\*(Aqinterfaccia da usare per visualizzare le informazioni all\*(Aqutente\&. Attualmente le interfacce sono:
.PP
pager
.RS 4
Uses
\fBsensible-pager\fR(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\&.
.RE
.PP
browser
.RS 4
Displays an HTML\-formatted changelog with hyperlinks for bugs and email addresses using the
\fBsensible-browser\fR(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\&.
.RE
.PP
xterm\-pager
.RS 4
Usa il paginatore preferito per mostrare l\*(Aqoutput all\*(Aqinterno di un xterm (usando un x\-terminal\-emulator) separato\&. Questo permette di proseguire con l\*(Aqaggiornamento e di continuare a vedere lo storico delle modifiche\&. Si può cambiare l\*(Aqemulatore di terminale da usare tramite l\*(Aqopzione «xterm» nel file di configurazione\&.
.RE
.PP
xterm\-browser
.RS 4
La combinazione logica di xterm\-pager e browser\&. Adatta solo ai browser testuali\&.
.RE
.PP
text
.RS 4
Trasferisce l\*(Aqoutput su stdout, senza pause\&.
.RE
.PP
mail
.RS 4
Invia email all\*(Aqindirizzo specificato con \-\-email\-address e non visualizza lo storico delle modifiche\&.
.RE
.PP
gtk
.RS 4
Spawns a gtk window to display the changelogs\&. Needs python3\-gi to be installed\&.
.RE
.PP
none
.RS 4
Non fa nulla\&. Questa opzione può essere usata per evitare l\*(Aquso di apt\-listchanges quando è già configurato per essere usato automaticamente da apt\&.
.RE
.sp
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\&.
.RE
.PP
\fB\-\-email\-address=\fR\fB\fIindirizzo\fR\fR
.RS 4
Oltre che ad essere visualizzato, una copia dello storico delle modifiche è inviata all\*(Aqindirizzo specificato\&. Per inviare solamente lo storico delle modifiche usare questa opzione con l\*(Aqinterfaccia mail\&.
.RE
.PP
\fB\-\-email\-format={text|html}\fR
.RS 4
If sending mail copies is enabled (see
\fB\-\-email\-address\fR
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\&.
.RE
.PP
\fB\-c, \-\-confirm\fR
.RS 4
Una volta visualizzato lo storico delle modifiche chiede all\*(Aqutente se desidera proseguire\&. Se l\*(Aqutente sceglie di non proseguire viene restituito all\*(Aquscita un valore non\-nullo e apt verrà interrotto\&.
.RE
.PP
\fB\-a, \-\-show\-all\fR
.RS 4
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\*(Aqintero storico delle modifiche di un \&.deb prima di estrarlo\&.
.RE
.PP
\fB\-\-save\-seen=\fR\fB\fIfile\fR\fR
.RS 4
Questa opzione forzerà apt\-listchanges a tener traccia dell\*(Aqultima 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\&.
.RE
.PP
\fB\-\-dump\-seen\fR
.RS 4
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
\fB\-\-save\-seen\fR
option or pass
\fB\-\-profile=apt\fR
option to have it read from the configuration file\&.
.RE
.PP
\fB\-\-since=\fR\fB\fIversion\fR\fR
.RS 4
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\&.
.RE
.PP
\fB\-\-which={news|changelogs|both}\fR
.RS 4
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\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Visualizza informazioni sulla sintassi\&.
.RE
.PP
\fB\-h, \-\-headers\fR
.RS 4
Queste opzioni causano l\*(Aqinserimento 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)\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Visualizza alcune informazioni per il debug\&.
.RE
.PP
\fB\-\-profile=\fR\fB\fInome\fR\fR
.RS 4
Seleziona un profilo\&.
\fInome\fR
corrisponde a una sezione nel file
/etc/apt/listchanges\&.conf\&. Il valore predefinito è \(lqapt\(rq quando avviato da apt e \(lqcmdline\(rq negli altri casi\&.
.RE
.PP
\fB\-\-reverse\fR
.RS 4
Show the changelog entries in reverse order\&.
.RE
.PP
\fB\-\-ignore\-apt\-assume\fR, \fB\-\-ignore\-debian\-frontend\fR
.RS 4
Disable forcing non\-interactive frontend in some of the cases described in the "AUTOMATIC FRONTEND OVERRIDE" section below\&.
.RE
.PP
\fB\-\-select\-frontend\fR
.RS 4
Choose frontend interactively\&. This option is mainly for testing purposes, please do not use it\&.
.RE
.SH "AUTOMATIC FRONTEND OVERRIDE"
.PP
For a better integration with existing package management tools,
\fBapt\-listchanges\fR
tries to detect if package upgrades are done in a non\-interactive way, and automatically switches its frontend to \*(Aqtext\*(Aq when
\fIany\fR
of the following conditions is satisfied:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the standard output is not connected to terminal;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the
\fB\-\-quiet\fR
(\fB\-q\fR) option is given to
\fBapt-get\fR(8)
(or
\fBaptitude\fR(8)); note however that when the option is used more than once, apt\-listchanges switches the frontend to \*(Aqmail\*(Aq;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the
\fB\-\-assume\-yes\fR
(\fB\-y\fR) option is given to
\fBapt-get\fR(8);
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
the
\fBDEBIAN_FRONTEND\fR
environment variable is set to "noninteractive", and
\fBAPT_LISTCHANGES_FRONTED\fR
is not set\&.
.RE
.PP
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:
\fB\-\-ignore\-apt\-assume\fR
or
\fB\-\-ignore\-debian\-frontend\fR\&.
.PP
Please also note that the "mail" frontend is already non\-interactive one, so it is never switched to the "text" frontend\&.
.PP
Additionally
\fBapt\-listchanges\fR
overrides X11\-based frontends ("gtk", "xterm\-pager", "xterm\-browser") with "pager" (or "browser" in case of "xterm\-browser") when the environment variable
\fBDISPLAY\fR
is not set\&.
.SH "CONFIGURATION FILE"
.PP
\fBapt\-listchanges\fR
reads its configuration from the
/etc/apt/listchanges\&.conf\&. The file consists of
\fIsections\fR
with names enclosed in the square brackets\&. Each section should contain lines in the
\fIkey\fR=\fIvalue\fR
format\&. Lines starting with the "#" sign are treated as comments and ignored\&.
.PP
\fISection\fR
is a name of profile that can be used as parameter of the
\fB\-\-profile\fR
option\&.
.PP
\fIKey\fR
is a name of some command\-line option (except for
\fB\-\-apt\fR,
\fB\-\-profile\fR,
\fB\-\-help\fR) with the initial hyphens removed, and the remaining hyphens translated to underscores, for example: "email_format" or "save_seen"\&.
.PP
\fIValue\fR
represents the value of the corresponding option\&. For command\-line options that do not take argument, like "confirm" or "header", the
\fIvalue\fR
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\&.
.PP
Additionally
\fIkey\fR
can be one of the following keywords: "browser", "pager" or "xterm"\&. The
\fIvalue\fR
of such configuration entry should be the name of an appropriate command, eventually followed by its arguments, for example: "pager=less \-R"\&.
.PP
\fBEsempio 1. File di configurazione di esempio\fR
.sp
.if n \{\
.RS 4
.\}
.nf
[cmdline]
frontend=pager

[apt]
frontend=xterm\-pager
email_address=root
confirm=1

[custom]
frontend=browser
browser=mozilla
.fi
.if n \{\
.RE
.\}
.PP
Il precedente file di configurazione specifica che in modalità a riga di comando l\*(Aqinterfaccia predefinita deve essere pager; invece in modalità apt l\*(Aqinterfaccia 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\*(Aqinterfaccia browser che utilizza mozilla\&.
.SH "AMBIENTE"
.PP
APT_LISTCHANGES_FRONTEND
.RS 4
Interfaccia da usare\&.
.RE
.PP
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
.RS 4
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
\fBapt\-listchanges\fR
is started by a privileged user\&.
.RE
.PP
DEBIAN_FRONTEND
.RS 4
If set to "noninteractive", then it can force
\fBapt\-listchanges\fR
to use non\-interactive frontend, see the "AUTOMATIC FRONTEND OVERRIDE" section for details\&.
.RE
.PP
BROWSER
.RS 4
Usata dall\*(Aqinterfaccia browser, deve essere impostata con un comando che si aspetti un URL file: di un file HTML da visualizzare\&.
.RE
.PP
PAGER
.RS 4
Used by the pager frontend\&.
.RE
.PP
APT_HOOK_INFO_FD
.RS 4
File descriptor to read package names from in the
\fB\-\-apt\fR
mode\&. (Apt is expected to set this variable to a proper file descriptor number)\&.
.RE
.SH "FILE"
.PP
/etc/apt/listchanges\&.conf
.RS 4
Configuration file\&.
.RE
.PP
/etc/apt/apt\&.conf\&.d/20listchanges
.RS 4
File used for registering apt\-listchanges into apt system\&.
.RE
.PP
/var/lib/apt/listchanges\&.db
.RS 4
Database usato per il "già\-visto"\&.
.RE
.SH "AUTORE"
.PP
apt\-listchanges è stato scritto da Matt Zimmerman <mdz@debian\&.org>
.SH "VEDERE ANCHE"
.PP
\fBsensible-pager\fR(1),
\fBsensible-browser\fR(1),
\fBapt-get\fR(8),
\fBaptitude\fR(8)