NOMBRE¶
apt-listchanges - Muestra las nuevas entradas de los ficheros de
cambios de los paquetes de Debian
SINOPSIS¶
apt-listchanges [[options...]] {[--apt] |
[package.deb...]}
DESCRIPCIÓN¶
apt-listchanges 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.
Esto se realiza extrayendo las entradas relevantes de los ficheros
NEWS.Debian y changelog[.Debian], normalmente se encuentran en
/usr/share/doc/paquete, de los archivos de paquetes 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.
OPCIONES¶
--apt
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.
-v, --verbose
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.
-f, --frontend
Selecciona la interfaz a usar para mostrar la
información al usuario. Las interfaces actuales son:
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 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".
xterm-browser
The logical combination of xterm-pager and browser. Only
appropriate for text-mode browsers.
text
Vuelca la salida a stdout, sin pausas.
mail
Manda correos a las direcciones especificadas con
--email-address, y no muestra los cambios.
gtk
Spawns a gtk window to display the changelogs. Needs
python3-gi to be installed.
none
No hace nada. Puede usarse para prevenir que
apt-listchanges se ejecuta cunado se invoque apt de forma
automática.
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=dirección
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 '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 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á.
-a, --show-all
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.
--save-seen=fichero
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.
--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}
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.
--help
Muestra información acerca de la sintaxis.
-h, --headers
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).
--debug
Muestra alguna información de
depuración.
--profile=nombre
Selecciona un perfil. nombre 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.
--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".
Ejemplo 1. Fichero de configuración de ejemplo
[cmdline]
frontend=pager
[apt]
frontend=xterm-pager
email_address=root
confirm=1
[custom]
frontend=browser
browser=mozilla
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.
ENTORNO¶
APT_LISTCHANGES_FRONTEND
Interfaz a usar.
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
Usado por la interfaz browser, debería ser una
orden que espere una URL de un fichero en formato HTML a mostrar.
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).
FICHEROS¶
/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
Base de datos usada por save-seen.
AUTOR¶
apt-listchanges fue escrito por Matt Zimmerman
<mdz@debian.org>
TRADUCTOR¶
Traducción de Rubén Porras Campo
<debian-l10n-spanish@lists.debian.org>