'\" t
.\"     Title: apt-listchanges
.\"    Author: Matt Zimmerman
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2017-07-08
.\"    Manual: Debian
.\"    Source: apt-listchanges
.\"  Language: Portuguese
.\"
.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 "NOME"
apt-listchanges \- Mostra novas entradas em changelog a partir de arquivos de pacotes Debian
.SH "SINOPSE"
.HP \w'\fBapt\-listchanges\fR\ 'u
\fBapt\-listchanges\fR [[\fIopções\fR...]] {[\fB\-\-apt\fR] | [\fIpacote\&.deb\fR...]}
.SH "DESCRIÇÃO"
.PP
\fBapt\-listchanges\fR
é uma ferramenta para mostrar o que foi alterado numa nova versão de um pacote Debian, em comparação com versão instalada actualmente no sistema\&.
.PP
Faz isto ao extrair as entradas relevantes de ambos NEWS\&.Debian e ficheiros changelog[\&.Debian], normalmente encontrados em
/usr/share/doc/\fIpacote\fR, a partir de arquivos de pacotes Debian\&.
.PP
Por favor note que na instalação predefinida se o
\fBapt\-listchanges\fR
for accionado durante actualizações como um plugin do APT, apenas mostra entradas de NEWS\&.Debian\&. Isto pode ser alterado com a opção
\fB\-\-which\fR\&.
.PP
Se forem mostradas entradas changelog e o
\fIpacote\fR
não conter o ficheiro changelog[\&.Debian], o
\fBapt\-listchanges\fR
chama o comando
\fBapt\-get changelog\fR
para descarregar o changelog da rede\&. Este comportamento pode ser desactivado com a opção
\fB\-\-no\-network\fR\&.
.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 then by the package name\&. Changes within each package group are displayed in the order of their appearance 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 "OPÇÕES"
.PP
\fBapt\-listchanges\fR
fornece as seguintes opções para controlar o seu comportamento\&. A maioria delas têm entradas equivalentes no ficheiro de configuração, veja "FICHEIRO DE CONFIGURAÇÃO" em baixo para detalhes\&.
.PP
\fB\-\-apt\fR
.RS 4
Lê nomes de ficheiros a partir de canalização especialmente formatada (como fornecido pelo apt), em vez de a partir de argumentos de linha de comandos, e honra certas opções específicas do apt no ficheiro de configuração\&. Esta canalização (pipeline) tem de estar no formato da "versão 2", especificado na configuração do apt\&.
.RE
.PP
\fB\-v, \-\-verbose\fR
.RS 4
Mostra informação adicional (normalmente não desejada)\&. Por exemplo, mostra uma mensagem quando um pacote da mesma versão ou anterior está para ser instalado, ou quando um pacote está para ser instalado pela primeira vez\&.
.RE
.PP
\fB\-f, \-\-frontend\fR
.RS 4
Selecciona qual frontend a usar para mostrar informação ao utilizador\&. Os frontends actuais incluem:
.PP
pager
.RS 4
usa o comando
\fBsensible-pager\fR(1)
para mostrar os resultados\&. O comando usa a variável de ambiente PAGER para escolher o seu pager favorito\&. A opção "pager" pode ser especificada no ficheiro de configuração para seleccionar um pager específico para usar com o apt\-listchanges\&.
.RE
.PP
browser
.RS 4
Mostra o changelog formatado em HTML com hiperligações para bugs e endereços de email usando o comando
\fBsensible-browser\fR(1)
que examina a variável de ambiente BROWSER para escolher o seu navegador favorito\&. A opção "browser" pode ser especificada no ficheiro de configuração para seleccionar um navegador específico para usar com o apt\-listchanges\&.
.RE
.PP
xterm\-pager
.RS 4
Usa o seu paginador favorito para mostrar resultados, mas fá\-lo num xterm (usando a alternativa x\-terminal\-emulator) nos bastidores\&. Isto permite\-lhe continuar com a actualização se desejar, e continuar a navegar nos changelogs\&. Você pode sobrepor o emulador de terminar a ser usado com a opção de configuração "xterm" \&.
.RE
.PP
xterm\-browser
.RS 4
A combinação lógica de xterm\-pager e browser\&. Apenas apropriada para navegadores de modo\-de\-texto\&.
.RE
.PP
text
.RS 4
Despeja os resultados no stdout, sem pausas\&.
.RE
.PP
syslog
.RS 4
Despeja os resultados para o syslog\&. É recomendado desactivar a opção titled\&.
.RE
.PP
log
.RS 4
Acrescenta o resultado a um ficheiro log, com um filtro opcional de processo\&. É recomendado desactivar a opção titled\&.
.RE
.PP
mail
.RS 4
Envia mail para o endereço especificado com \-\-email\-address, e não mostra os changelogs\&.
.RE
.PP
gtk
.RS 4
Gera uma janela gtk para mostrar os changelogs\&. Precisa do python3\-gi instalado\&.
.RE
.PP
none
.RS 4
Não faz nada\&. Pode ser usado para impedir que o apt\-listchanges corra quando configurado para correr automaticamente a partir do apt\&.
.RE
.sp
Por favor note que o apt\-listchanges irá tentar mudar para um utilizador sem privilégios antes de criar comandos nos frontends "browser", "xterm\-browser", e "xterm\-pager"\&. No entanto, isto presentemente não se aplica ao frontend "pager"\&. Veja também "VARIÁVEIS DE AMBIENTE" em baixo\&.
.RE
.PP
\fB\-\-email\-address=\fR\fB\fIendereço\fR\fR
.RS 4
Adicionalmente a mostrá\-los, envia por mail uma cópia dos dados de changelog para o endereço especificado\&. Para apenas enviar por mail as entradas de changelog, use esta opção com o frontend especial \*(Aqmail\*(Aq\&.
.RE
.PP
\fB\-\-email\-format={text|html}\fR
.RS 4
Se o envio de cópias por mail estiver activo (veja
\fB\-\-email\-address\fR
em cima), esta opção selecciona se o mail deve ser enviado nos antigos e bons dados em texto simples (o que é o comportamento predefinido), ou em dados html com ligações para se clicar, o que pode ser mais conveniente para pessoas que usem clientes de mail gráficos\&.
.RE
.PP
\fB\-c, \-\-confirm\fR
.RS 4
Após mostrar os changelogs, pergunta ao utilizador se deve ou não prosseguir\&. Se o utilizador escolher não prosseguir, será devolvido um estado de saída não\-zero, e o apt irá abortar\&.
.RE
.PP
\fB\-a, \-\-show\-all\fR
.RS 4
Em vez de tentar mostrar entradas changelog que sejam mais recentes que a versão actualmente instalada do pacote, simplesmente mostra todas as entradas changelog para todos os pacotes\&. Isto é útil para visualizar o changelog inteiro de um \&.deb antes de o extrair\&.
.RE
.PP
\fB\-n, \-\-no\-network\fR
.RS 4
Em casos raros quando um pacote binário (ou para ser mais preciso; nenhum dos pacotes binários compilados a partir do mesmo pacote fonte e que são processados juntamente em grupo) não contém um ficheiro changelog, por predefinição o
\fBapt\-listchanges\fR
executa
\fBapt\-get changelog\fR
para descarregar changelogs a partir dos servidores de rede normalmente disponibilizados pela distribuição do seu sistema operativo\&. Esta opção irá desactivar este comportamento, o que pode ser útil por exemplo para sistemas atrás de uma firewall\&.
.RE
.PP
\fB\-\-save\-seen=\fR\fB\fIficheiro\fR\fR
.RS 4
Esta opção irá fazer com que o apt\-listchanges acompanhe a última versão de um pacote para o qual changelogs foram mostrados, para evitar re\-mostrar os mesmos changelogs numa futura invocação\&. A base de dados é armazenada no ficheiro nomeado\&. Especifique \*(Aqnone\*(Aq para desactivar esta funcionalidade\&.
.RE
.PP
\fB\-\-dump\-seen\fR
.RS 4
Mostra o conteúdo da base de dados vista na saída standard como uma lista de linhas consistindo do nome do pacote fonte e a sua versão vista mais recente, separados por espaço\&. Esta opção requer o caminho para a base de dados vista seja conhecido: por favor ou o especifique\-o usando a opção
\fB\-\-save\-seen\fR
ou passe a opção
\fB\-\-profile=apt\fR
para ele ser lido a partir do ficheiro de configuração\&.
.RE
.PP
\fB\-\-since=\fR\fB\fIversão\fR\fR
.RS 4
Esta opção irá fazer com que o apt\-listchanges as entradas posteriores à versão especificada\&. Com esta opção, o único outro argumento que você pode passar é o caminho para um ficheiro \&.deb\&.
.RE
.PP
\fB\-\-latest=\fR\fB\fIN\fR\fR
.RS 4
Esta opção irá fazer com que o apt\-listchanges apenas mostre as
\fIN\fR
entradas mais recentes\&. Com esta opção, o único outro argumento que você pode passar é o caminho para um ficheiro \&.deb\&.
.RE
.PP
\fB\-\-which={news|changelogs|both}\fR
.RS 4
Esta opção selecciona se notícias (de NEWS\&.Debian et al\&.), changelogs (de changelog\&.Debian et al\&.) ou ambos devem ser mostrados\&. A predefinição é de apenas mostrar as noticias\&.
.RE
.PP
\fB\-\-help\fR
.RS 4
Mostrar informação de sintaxe\&.
.RE
.PP
\fB\-h, \-\-headers\fR
.RS 4
estas opções irão fazer com que o apt\-listchanges insira um cabeçalho antes de cada changelog do pacote a mostrar o nome do pacote, e os nomes dos pacotes binários que estão a ser actualizados (se existir mais do que um, ou se for diferente do nome do pacote fonte)\&.
.RE
.PP
\fB\-\-debug\fR
.RS 4
Mostra alguma informação de depuração\&.
.RE
.PP
\fB\-\-profile=\fR\fB\fInome\fR\fR
.RS 4
Selecciona um perfil de opção\&.
\fInome\fR
corresponde a uma secção em
/etc/apt/listchanges\&.conf\&. A predefinição quando invocada a partir do apt é "apt", e caso contrário "cmdline"\&.
.RE
.PP
\fB\-\-log=\fR\fB\fIfile\fR\fR
.RS 4
Seleciona o ficheiro acrescentado pelo frontend log\&. A predefinição é
/var/log/apt/listchanges\&.log\&. Pode ser usada a opção de comando de filtragem para modificar os resultados antes de serem acrescentados ao ficheiro log\&. Por favor assegure que configura a rotação de log para este ficheiro\&.
.RE
.PP
\fB\-\-filter=\fR\fB\fIcommand\fR\fR
.RS 4
Seleciona o comando usado para filtrar resultados antes de serem acrescentados ao ficheiro log pelo frontend log\&. O stdin irá receber o resultado de
\fBapt\-listchanges\fR
e o stdout será acrescentado ao ficheiro log\&. Separa os argumentos com espaços e cita os argumentos que contém espaços\&. O comando não irá correr usando a shell a menos que a shell seja incluída no comando:
\fBsh \-c \*(Aqdate ; cat\*(Aq\fR
.RE
.PP
\fB\-\-reverse\fR
.RS 4
Mostra as entradas do changelog em ordem inversa\&.
.RE
.PP
\fB\-\-ignore\-apt\-assume\fR, \fB\-\-ignore\-debian\-frontend\fR
.RS 4
Desactiva o forçar de frontend não\-interactivo em alguns dos casos descritos na secção "SOBREPOSIÇÃO AUTOMÁTICA DE FRONTEND" em baixo\&.
.RE
.PP
\fB\-\-titled\fR, \fB\-\-untitled\fR
.RS 4
Activa ou desactiva o título no inicio dos resultados\&.
.RE
.PP
\fB\-\-select\-frontend\fR
.RS 4
Escolhe o frontend interactivamente\&. Esta opções é principalmente para objectivos de testes, por favor não a use\&.
.RE
.SH "SOBREPOSIÇÃO AUTOMÁTICA DE FRONTEND"
.PP
Para uma melhor integração com as ferramentas existentes de gestão de pacotes, o
\fBapt\-listchanges\fR
tenta detectar se as actualizações de pacotes são feitas num modo não\-interactivo, e muda automaticamente o seu frontend para \*(Aqtext\*(Aq quando
\fIqualquer\fR
das seguintes condições é satisfeita\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a saída standard não está ligada ao terminal:
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a opção
\fB\-\-quiet\fR
(\fB\-q\fR) é dada ao
\fBapt-get\fR(8)
(ou
\fBaptitude\fR(8)); note no entanto que quando a opção é usada mais do que uma vez, o apt\-listchanges muda o frontend para \*(Aqmail\*(Aq;
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a opção
\fB\-\-assume\-yes\fR
(\fB\-y\fR) é dada ao
\fBapt-get\fR(8);
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
a variável de ambiente
\fBDEBIAN_FRONTEND\fR
é definida para "noninteractive", e
\fBAPT_LISTCHANGES_FRONTED\fR
não é definida\&.
.RE
.PP
Por objectivos de compatibilidade com verses anteriores, as últimas duas verificações de cima podem ser desactivadas com as entradas no ficheiro de configuração "ignore_apt_assume=true" ou "ignore_debian_frontend=true" (veja "FICHEIRO DE CONFIGURAÇÃO em baixo) ou ao usar as opções de linha de comandos
\fB\-\-ignore\-apt\-assume\fR
ou
\fB\-\-ignore\-debian\-frontend\fR\&.
.PP
Por favor note também que o frontend "mail" já é um não\-interactivo, assim nunca é mudado para o frontend "text"\&.
.PP
Adicionalmente o
\fBapt\-listchanges\fR
sobrepões os frontends baseados em X11 ("gtk", "xterm\-pager", "xterm\-browser") com "pager" (ou "browser" no caso de "xterm\-browser") quando a variável de ambiente
\fBDISPLAY\fR
não está definida\&.
.PP
Por favor note que estes frontends silenciosos não são sujeitos a sobreposições: syslog log
.SH "FICHEIRO DE CONFIGURAÇÃO"
.PP
\fBapt\-listchanges\fR
lê a sua configuração a partir de
/etc/apt/listchanges\&.conf\&. O ficheiro consiste de
\fIsecções\fR
com nomes dentro de parênteses rectos\&. Cada secção deve conter linhas no formato
\fIchave\fR=\fIvalor\fR\&. As linhas começadas com o sinal "#" são tratadas como comentários e ignoradas\&. Os ficheiros nomeados
\fIname\fR\&.conf
no directório
/etc/apt/listchanges\&.conf\&.d
são também lidos do mesmo modo e sobrepõem valores definidos no ficheiro de configuração principal\&.
.PP
\fISecção\fR
é um nome de perfil que pode ser usado como parâmetro da opção
\fB\-\-profile\fR\&.
.PP
A configuração da secção "apt" pode ser gerida por
\fBdebconf\fR(7), e a maioria dos ajustes lá podem ser alterados com a ajuda do comando
\fBdpkg\-reconfigure apt\-listchanges\fR\&.
.PP
\fIChave\fR
é um nome de algumas opções de linha de comando (excepto para
\fB\-\-apt\fR,
\fB\-\-profile\fR,
\fB\-\-help\fR) com os hífenes iniciais removidos, e os hífenes restantes convertidos em underscores, por exemplo: "email_format" ou "save_seen"\&.
.PP
\fIValor\fR
representa o valor da opção correspondente\&. Para opções de linha de comandos que não aceitam argumentos, como "confirm" ou "headers", o
\fIvalor\fR
deve ser definido ou para "1", "yes", "true", e "on" de modo a activar a opção, ou para "0", "no", "false", e "off" para a desactivar\&.
.PP
Adicionalmente
\fIchave\fR
pode ser uma das seguintes palavras\-chave: "browser", "pager" ou "xterm"\&. O
\fIvalor\fR
de tal entrada de configuração deve ser o nome de um comando apropriado, eventualmente seguido dos seus argumentos, por exemplo : "pager=less \-R"\&.
.PP
\fBExemplo 1. Exemplo de ficheiro de configuração\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
O ficheiro de configuração em cima especifica que em modo de linha de comandos, o frontend predefinido deve ser "pager"\&. Em modo do apt, o frontend xterm\-pager é o predefinido, deve ser enviada por mail para o root uma cópia dos changelogs (se algum), e o apt\-listchanges deve perguntar por confirmação\&. se o apt\-listchanges for invocado com \-\-profile=custom, será usado o frontend browser, e invocar o mozilla\&.
.SH "AMBIENTE"
.PP
APT_LISTCHANGES_FRONTEND
.RS 4
Frontend a usar\&.
.RE
.PP
APT_LISTCHANGES_USER, SUDO_USER, USERNAME
.RS 4
O valor da primeira das variáveis de cima a existir será usado como o nome do utilizador para o qual mudar quando corre comandos gerados pelos frontends "browser", "xterm\-browser", e "xterm\-pager" se o
\fBapt\-listchanges\fR
for arrancado por um utilizador com privilégios\&.
.RE
.PP
DEBIAN_FRONTEND
.RS 4
Se definido para "noninteractive", então pode forçar o
\fBapt\-listchanges\fR
a usar um frontend não\-interactivo, veja a secção SOBREPOSIÇÃO AUTOMÁTICA DE FRONTEND para detalhes\&.
.RE
.PP
BROWSER
.RS 4
usado pelo frontend browser, deve ser regulado para um comando que espere um ficheiro: URL para um ficheiro HTML file a mostrar\&.
.RE
.PP
PAGER
.RS 4
Usado pelo frontend pager
.RE
.PP
APT_HOOK_INFO_FD
.RS 4
Descritor de ficheiro de onde ler nomes de pacotes no modo
\fB\-\-apt\fR\&. (Espera\-se que o apt regule esta variável para um número de descritor de ficheiro apropriado)\&.
.RE
.SH "FICHEIROS"
.PP
/etc/apt/listchanges\&.conf
.RS 4
Ficheiro de configuração\&.
.RE
.PP
/etc/apt/listchanges\&.conf\&.d/*\&.conf
.RS 4
Ficheiros de sobreposição ao ficheiro de configuração\&.
.RE
.PP
/etc/apt/apt\&.conf\&.d/20listchanges
.RS 4
Ficheiro usado para registar apt\-listchanges no sistema apt\&.
.RE
.PP
/var/lib/apt/listchanges\&.db
.RS 4
Base de dados usada para save\-seen\&.
.RE
.SH "AUTOR"
.PP
apt\-listchanges foi escrito por Matt Zimmerman <mdz@debian\&.org>
.PP
O manutenção actual é feita por Robert Luberda <robert@debian\&.org>
.SH "VEJA TAMBÉM"
.PP
\fBsensible-pager\fR(1),
\fBsensible-browser\fR(1),
\fBapt-get\fR(8),
\fBaptitude\fR(8)