DH_INSTALLCHANGELOGS(1)

NOME
dh_installchangelogs - instala relatórios de alterações (changelogs) em directórios de compilação de pacotes.

RESUMO
dh_installchangelogs [debhelper opções] [-k] [-Xitem] [--no-trim] [upstream]

DESCRIÇÃO
dh_installchangelogs é um programa debhelper que é responsável por instalar relatórios de alterações (changelogs) nos directórios de compilação de pacotes.

Pode ser especificado como uma opção um ficheiro changelog do autor original (upstream) Se nenhum for especificado, dh_installchangelogs pode procurar por ficheiros cujos nomes apontam provavelmente para relatórios de alterações como descrito nos próximos parágrafos.

Em pacotes não-nativos, o dh_installchangelogs irá primeiro procurar por ficheiros changelog instalados pelo sistema de compilação do autor em usr/share/doc/package (do directório de compilação do pacote) e renomear o melhor candidato (se existir algum) para usr/share/doc/pacote/changelog. Note que dh_installchangelogs não procura nenhum directório fonte (tal como debian/tmp). Caso contrário, dh_installchangelogs (no nível de compatibilidade 7 ou posterior) irá procurar por ficheiros changelog no directório fonte (ex. a raiz do sub-directório docs). Irá procurar por changelog, changes e history opcionalmente com extensões comuns (tais como .txt, .md, .rst, .org, etc.)

Se um ficheiro changelog for especificado e se for um ficheiro html (determinado pela extensão do ficheiro), em vez disso será instalado como usr/share/doc/package/changelog.html. Se o relatório html for convertido para texto simples, essa variante pode ser especificada como um segundo parâmetro. Quando nenhuma variante de texto simples é especificada, é gerado um curto usr/share/doc/package/changelog, apontando os leitores para o ficheiro de relatório em html.

Os registos de alterações Debian estilo-debchange são cortados para incluir apenas entradas mais recentes que a data de lançamento de oldstable. Nenhum corte será executado se a opção --no-trim for passada ou se a variável de ambiente DEB_BUILD_OPTIONS conter notrimdch.

FICHEIROS

debian/changelog
debian/NEWS
debian/pacote.changelog
debian/pacote.NEWS
    Instalado automaticamente em usr/share/doc/pacote/ no directório de compilação do pacote.

    Usa o nome específico do pacote se o pacote precisar de um ficheiro NEWS ou changelog diferente.

    O ficheiro changelog é instalado com o nome changelog para os pacotes nativos, e changelog.Debian para pacotes não-nativos. O ficheiro de NOTICIAS é sempre instalado com o nome NEWS.Debian.

OPÇÕES

-k, --keep
    Mantêm o nome original do registo de alterações do autor. Isto será conseguido ao instalar o registo de alterações do autor como changelog, e criando um link simbólico daí para o nome original do ficheiro changelog. Isto pode ser útil se o registo de alterações do autor tiver um nome fora do usual, ou se outra documentação no pacote faça referência ao ficheiro changelog.

-Xitem, --exclude=item
    Exclui ficheiros changelog do autor que contenham item em qualquer ponto do seu nome de ficheiro, de serem instalados.

    Note que o nome de directório do changelog é também parte correspondente.

--no-trim
    Instala o registo de alterações completo, não a sua versão cortada que só inclui as entradas recentes.

upstream
    Instala este ficheiro como o registo de alterações (changelog) da origem.

VEJA TAMBÉM
debhelper(7)

Este programa é parte do debhelper.

AUTOR
Joey Hess <joeyh@debian.org>

TRADUÇÃO
Américo Monteiro

Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro a_monteiro@gmx.com ou Equipa Debian de Tradução Portuguesa traduz@debianpt.org.