'\" 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: Spanish
.\"
.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 "NOMBRE"
apt-listchanges \- Muestra las nuevas entradas de los ficheros de cambios de los paquetes de Debian
.SH "SINOPSIS"
.HP \w'\fBapt\-listchanges\fR\ 'u
\fBapt\-listchanges\fR [[\fIoptions\fR...]] {[\fB\-\-apt\fR] | [\fIpackage\&.deb\fR...]}
.SH "DESCRIPCIÓN"
.PP
\fBapt\-listchanges\fR
es una herramienta que muestra los cambios de una nueva versión de un paquete de Debian respecto a la versión instalada actualmente en el sistema\&.
.PP
Esto se realiza extrayendo las entradas relevantes de los ficheros NEWS\&.Debian y changelog[\&.Debian], normalmente se encuentran en
/usr/share/doc/\fIpaquete\fR, de los archivos de paquetes 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 "OPCIONES"
.PP
\fB\-\-apt\fR
.RS 4
Lee los nombres de los ficheros de una tubería con un formato especial (tal como lo proporciona apt), en vez de la línea de órdenes, y tiene en cuenta ciertas opciones especificas de apt en el fichero de configuración\&. Esta tubería debe estar en el formato de la "versión 2", especificado en el fichero de configuración de apt\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Muestra información adicional (normalmente no se quiere)\&. Por ejemplo, mostrar un mensaje cuando un paquete con la misma versión o anterior va a ser instalado, o cuando es la primera vez que se instala el paquete\&.
.RE
.PP
\fB\-f, \-\-frontend\fR
.RS 4
Selecciona la interfaz a usar para mostrar la información al usuario\&. Las interfaces actuales son:
.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 su paginador favorito para mostrar la salida, pero lo hace sobre un xterm (usando la alternativa x\-terminal\-emulator) de fondo\&. Esto le permite realizar la actualización mientras mira los cambios\&. Puede cambiar el emulador de terminal con la opción "xterm"\&.
.RE
.PP
xterm\-browser
.RS 4
The logical combination of xterm\-pager and browser\&. Only appropriate for text\-mode browsers\&.
.RE
.PP
text
.RS 4
Vuelca la salida a stdout, sin pausas\&.
.RE
.PP
mail
.RS 4
Manda correos a las direcciones especificadas con \-\-email\-address, y no muestra los cambios\&.
.RE
.PP
gtk
.RS 4
Spawns a gtk window to display the changelogs\&. Needs python3\-gi to be installed\&.
.RE
.PP
none
.RS 4
No hace nada\&. Puede usarse para prevenir que apt\-listchanges se ejecuta cunado se invoque apt de forma automática\&.
.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\fIdirección\fR\fR
.RS 4
Además de mostrar los cambios, mandar una copia a la dirección especificada\&. Si sólo quiere mandar los cambios, use esta opción junto con la interfaz \*(Aqmail\*(Aq\&.
.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 vez que se han mostrado los cambios, preguntar al usuario si desea continuar\&. Si el usuario elige no continuar, se devolverá un estado de salida distinto de cero, y apt abortará\&.
.RE
.PP
\fB\-a, \-\-show\-all\fR
.RS 4
En vez de tratar de mostrar los cambios desde la versión instalada, simplemente mostrar todos los cambios de todos los paquetes\&. Esto es útil para ver todo el fichero de cambios de un \&.deb antes de extraerlo\&.
.RE
.PP
\fB\-\-save\-seen=\fR\fB\fIfichero\fR\fR
.RS 4
Esta opción hará que apt\-listchanges lleve la cuenta de la última versión de un paquete para la que se han mostrado los cambios, para así, evitar mostrar los mismos cambios en futuras ejecuciones\&. La base de datos se guarda en el fichero especificado\&. Especifique «none» para deshabilitar esta característica\&.
.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
Esta opción indica si se deben mostrar la noticias (de NEWS\&.Debian et al\&.), registros de cambios (de changelog\&.Debian et al\&.) o ambos\&. Por omisión sólo se muestran las noticias\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Muestra información acerca de la sintaxis\&.
.RE
.PP
\fB\-h, \-\-headers\fR
.RS 4
Esta opción hará que apt\-listchanges inserte una cabecera antes de los cambios de cada paquete, mostrando el nombre del paquete, y los nombres de los paquetes binarios que van a ser actualizados (si es que hay más de uno o difiere respecto del nombre del paquete fuente)\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Muestra alguna información de depuración\&.
.RE
.PP
\fB\-\-profile=\fR\fB\fInombre\fR\fR
.RS 4
Selecciona un perfil\&.
\fInombre\fR
corresponde a una sección en
/etc/apt/listchanges\&.conf\&. De forma predeterminada, cuando se invoca desde apt es "apt", y "cmdline" en otro caso\&.
.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
\fBEjemplo 1. Fichero de configuración de ejemplo\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
El fichero de configuración anterior especifica que, en el modo línea de órdenes, la interfaz predeterminada es "pager"\&. En modo apt, la interfaz predeterminado es xterm\-pager, una copia de los cambios (si es que hay algunos) debe enviarse al superusuario, y apt\-listchanges debe pedir confirmación\&. Si se invoca a apt\-listchanges con \-\-profile=custom se usará la interfaz de navegador, y se ejecutará mozilla\&.
.SH "ENTORNO"
.PP
APT_LISTCHANGES_FRONTEND
.RS 4
Interfaz a usar\&.
.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
Usado por la interfaz browser, debería ser una orden que espere una URL de un fichero en formato HTML a mostrar\&.
.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 "FICHEROS"
.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
Base de datos usada por save\-seen\&.
.RE
.SH "AUTOR"
.PP
apt\-listchanges fue escrito por Matt Zimmerman <mdz@debian\&.org>
.SH "VÉASE ADEMÁS"
.PP
\fBsensible-pager\fR(1),
\fBsensible-browser\fR(1),
\fBapt-get\fR(8),
\fBaptitude\fR(8)
.SH "TRADUCTOR"
.PP
Traducción de Rubén Porras Campo <debian\-l10n\-spanish@lists\&.debian\&.org>