.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "DH_INSTALLCHANGELOGS 1" .TH DH_INSTALLCHANGELOGS 1 2024-03-27 13.15.3 Debhelper .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH NOME .IX Header "NOME" dh_installchangelogs \- instala relatórios de alterações (changelogs) em directórios de compilação de pacotes. .SH RESUMO .IX Header "RESUMO" \&\fBdh_installchangelogs\fR [\fIdebhelper\ opções\fR] [\fB\-k\fR] [\fB\-X\fR\fIitem\fR] [\fB\-\-no\-trim\fR] [\fIupstream\fR] .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" \&\fBdh_installchangelogs\fR é um programa debhelper que é responsável por instalar relatórios de alterações (changelogs) nos directórios de compilação de pacotes. .PP Pode ser especificado como uma opção um ficheiro \fIchangelog\fR do autor original (upstream) Se nenhum for especificado, \fBdh_installchangelogs\fR pode procurar por ficheiros cujos nomes apontam provavelmente para relatórios de alterações como descrito nos próximos parágrafos. .PP Em pacotes não\-nativos, o \fBdh_installchangelogs\fR irá primeiro procurar por ficheiros changelog instalados pelo sistema de compilação do autor em \fIusr/share/doc/package\fR (do directório de compilação do pacote) e renomear o melhor candidato (se existir algum) para \fIusr/share/doc/pacote/changelog\fR. Note que \fBdh_installchangelogs\fR \fInão\fR procura nenhum directório fonte (tal como \fIdebian/tmp\fR). Caso contrário, \fBdh_installchangelogs\fR (no nível de compatibilidade 7 ou posterior) irá procurar por ficheiros changelog no directório fonte (ex. a raiz do sub\-directório \fIdocs\fR). Irá procurar por \fIchangelog\fR, \fIchanges\fR e \fIhistory\fR opcionalmente com extensões comuns (tais como \fI.txt\fR, \fI.md\fR e \fI.rst\fR). .PP Se um ficheiro changelog for especificado e se for um ficheiro \fIhtml\fR (determinado pela extensão do ficheiro), em vez disso será instalado como \fIusr/share/doc/package/changelog.html\fR. 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 \fIusr/share/doc/package/changelog\fR, apontando os leitores para o ficheiro de relatório em html. .PP Os registos de alterações Debian estilo\-\fBdebchange\fR são cortados para incluir apenas entradas mais recentes que a data de lançamento de \fIoldstable\fR. Nenhum corte será executado se a opção \fB\-\-no\-trim\fR for passada ou se a variável de ambiente \fBDEB_BUILD_OPTIONS\fR conter \fBnotrimdch\fR. .SH FICHEIROS .IX Header "FICHEIROS" .IP \fIdebian/changelog\fR 4 .IX Item "debian/changelog" .PD 0 .IP \fIdebian/NEWS\fR 4 .IX Item "debian/NEWS" .IP debian/\fIpacote\fR.changelog 4 .IX Item "debian/pacote.changelog" .IP debian/\fIpacote\fR.NEWS 4 .IX Item "debian/pacote.NEWS" .PD Instalado automaticamente em usr/share/doc/\fIpacote\fR/ no directório de compilação do pacote. .Sp Usa o nome específico do pacote se o \fIpacote\fR precisar de um ficheiro \fINEWS\fR ou \fIchangelog\fR diferente. .Sp O ficheiro \fIchangelog\fR é instalado com o nome changelog para os pacotes nativos, e \fIchangelog.Debian\fR para pacotes não\-nativos. O ficheiro de \fINOTICIAS\fR é sempre instalado com o nome \fINEWS.Debian\fR. .SH OPÇÕES .IX Header "OPÇÕES" .IP "\fB\-k\fR, \fB\-\-keep\fR" 4 .IX Item "-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 \fIchangelog\fR, e criando um link simbólico daí para o nome original do ficheiro \fIchangelog\fR. 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 \fIchangelog\fR. .IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4 .IX Item "-Xitem, --exclude=item" Exclui ficheiros \fIchangelog\fR do autor que contenham \fIitem\fR em qualquer ponto do seu nome de ficheiro, de serem instalados. .Sp Note que o nome de directório do changelog é também parte correspondente. .IP \fB\-\-no\-trim\fR 4 .IX Item "--no-trim" Instala o registo de alterações completo, não a sua versão cortada que só inclui as entradas recentes. .IP \fIupstream\fR 4 .IX Item "upstream" Instala este ficheiro como o registo de alterações (changelog) da origem. .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" \&\fBdebhelper\fR\|(7) .PP Este programa é parte do debhelper. .SH AUTOR .IX Header "AUTOR" Joey Hess .SH TRADUÇÃO .IX Header "TRADUÇÃO" Américo Monteiro .PP Se encontrar algum erro na tradução deste documento, por favor comunique para Américo Monteiro \fIa_monteiro@gmx.com\fR ou Equipa Debian de Tradução Portuguesa \fItraduz@debianpt.org\fR.