.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35) .\" .\" 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 .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . 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_INSTALLDOCS 1" .TH DH_INSTALLDOCS 1 "2019-09-14" "12.6" "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_installdocs \- instala documentação em directórios de compilação de pacotes .SH "RESUMO" .IX Header "RESUMO" \&\fBdh_installdocs\fR [\fIdebhelper opções\fR] [\fB\-A\fR] [\fB\-X\fR\fIitem\fR] [\fIficheiro\fR ...] .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" \&\fBdh_installdocs\fR é um programa debhelper que é responsável por instalar documentação em \fIusr/share/doc/package\fR nos directórios de compilação de pacotes. .PP Em compatibilidade 10 e anterior, \fBdh_install\fR\|(1) pode ser a melhor ferramenta para lidar com a documentação do autor, quando o sistema de compilação próprio do autor instala toda a documentação desejada correctamente Neste caso, o \fBdh_installdocs\fR ainda é útil para instalar documentação relacionada com o empacotamento (ex. o ficheiro \&\fIdebian/copyright\fR). .PP Desde nível de compatibilidade 11 do debhelper em diante, o \fBdh_install\fR irá procurar os ficheiros em \fIdebian/tmp\fR, se não os encontrar no directório actual (ou onde você o mandou procurar usando \fB\-\-sourcedir\fR). .PP Em compatibilidade 11 e posterior, \fBdh_installdocs\fR oferece muitas das características que o \fBdh_install\fR\|(1) também tem. Mais ainda, o \&\fBdh_installdocs\fR também suporta o perfil de compilação \fBnodoc\fR para excluir documentação (independentemente do nível de compatibilidade). .SH "FICHEIROS" .IX Header "FICHEIROS" .IP "debian/\fIpacote\fR.docs" 4 .IX Item "debian/pacote.docs" Lista os ficheiros de documentação a serem instalados em \fIpacote\fR. .IP "\fIdebian/copyright\fR" 4 .IX Item "debian/copyright" O ficheiro de copyright é instalado em todos os pacotes, a menos que esteja disponível um ficheiro de copyright mais específico. .IP "debian/\fIpacote\fR.copyright" 4 .IX Item "debian/pacote.copyright" .PD 0 .IP "debian/\fIpacote\fR.README.Debian" 4 .IX Item "debian/pacote.README.Debian" .IP "debian/\fIpacote\fR.TODO" 4 .IX Item "debian/pacote.TODO" .PD Cada um destes ficheiros são instalados automaticamente se presentes para um \&\fIpacote\fR. .IP "\fIdebian/README.Debian\fR" 4 .IX Item "debian/README.Debian" .PD 0 .IP "\fIdebian/TODO\fR" 4 .IX Item "debian/TODO" .PD Estes ficheiros são instalados no primeiro pacote binário listado em debian/control. .Sp Note que os ficheiros \fI\s-1README\s0.debian\fR são também instalados como \&\fI\s-1README\s0.Debian\fR, e os ficheiro \fI\s-1TODO\s0\fR serão instalados como \fI\s-1TODO\s0.Debian\fR em pacotes não nativos. .IP "debian/\fIpacote\fR.doc\-base" 4 .IX Item "debian/pacote.doc-base" instalado como ficheiros de controle doc-base. Note que o doc-id será determinado a partir da entrada \fBDocument:\fR no ficheiro de controle de doc-base em questão. Na eventualidade de múltiplos ficheiros doc-base num pacote fonte partilharem o mesmo doc-id, eles serão instalados em usr/share/doc\-base/package em vez de usr/share/doc\-base/doc\-id. .IP "debian/\fIpacote\fR.doc\-base.*" 4 .IX Item "debian/pacote.doc-base.*" Se o seu pacote precisa de registar mais do que um documento, você precisa de vários ficheiros baseados em doc, e pode nomeá\-los desta maneira. Na eventualidade de vários ficheiros baseados em doc deste estilo num único pacote fonte partilharem o mesmo doc-id, serão instalados em usr/share/doc\-base/package\-* em vez de usr/share/doc\-base/doc\-id. .SH "OPÇÕES" .IX Header "OPÇÕES" .IP "\fB\-A\fR, \fB\-\-all\fR" 4 .IX Item "-A, --all" Instala todos os ficheiros especificados pelos parâmetros de linha de comandos em \s-1TODOS\s0 os pacotes em que actua. .IP "\fB\-X\fR\fIitem\fR, \fB\-\-exclude=\fR\fIitem\fR" 4 .IX Item "-Xitem, --exclude=item" Exclui da instalação ficheiros que contenham \fIitem\fR em qualquer ponto do seu nome de ficheiro. Note que isto inclui ficheiros baseados em doc. .IP "\fB\-\-sourcedir=\fR\fIdirectório\fR" 4 .IX Item "--sourcedir=directório" Procura no directório especificado por ficheiros para serem instalados. Esta opção requer compatibilidade 11 ou posterior (é ignorada em silêncio na compatibilidade 10 ou anterior). .Sp Note que isto não é o mesmo que a opção \fB\-\-sourcedirectory\fR usada pelos comandos \fBdh_auto_\fR\fI*\fR. Você raramente vai precisar de usar esta opção, pois o \fBdh_installman\fR procura automaticamente por ficheiros em \&\fIdebian/tmp\fR no nível de compatibilidade 11 e superiores do debhelper. .IP "\fB\-\-doc\-main\-package=\fR\fImain-package\fR" 4 .IX Item "--doc-main-package=main-package" Define o pacote principal para pacote de documentação. Isto é usado para a documentação do pacote de documentação em \fI/usr/share/doc/\fImain-package\fI\fR como recomendado pelo manual de politicas Debian 3.9.7 em §12.3. .Sp Em compatibilidade 11 (ou posterior), esta opção apenas é útil se a auto\-detecção do debhelper do pacote principal está errada. A opção também pode ser usada para silenciar um aviso do debhelper quando a auto\-detecção falha mas acontece a predefinição estar correcta. .Sp Esta opção não pode ser usada quando o \fBdh_installdocs\fR é instruído a actuar em múltiplos pacotes. Se precisar desta opção, você irá geralmente precisar de combiná\-la com \fB\-p\fR para assegurar exactamente que um pacote é actuado. .Sp Por favor tenha em mente que alguma documentação (o ficheiro de copyright, \&\s-1README\s0.Debian, etc.) não serão afectados por esta opção. .IP "\fB\-\-link\-doc=\fR\fIpacote\fR" 4 .IX Item "--link-doc=pacote" Faz com que o directório de documentação de todos os pacotes onde actua seja um link simbólico para o directório de documentação do \fIpacote\fR. Isto não tem nenhum efeito quando se actual no próprio \fIpacote\fR, ou se o directório de documentação a ser criado já existir quando o \fBdh_installdocs\fR é executado. Para estar em conformidade com a política, o \fIpacote\fR tem de ser um pacote binário que vem do mesmo pacote fonte. .Sp O debhelper irá tentar evitar instalar ficheiros em directórios de documentação \*(L"linkados\*(R" que poderão causar conflitos com o pacotes \&\*(L"linkado\*(R". A opção \fB\-A\fR não terá nenhum efeito em pacotes com directórios de documentação \*(L"linkados\*(R", e os ficheiros \fIcopyright\fR, \fIchangelog\fR, \&\fI\s-1README\s0.Debian\fR, e \fI\s-1TODO\s0\fR não serão instalados. .Sp (Um outro método de consegui o mesmo, o qual ainda é suportado, é tornar o directório de documentação de um pacote num link simbólico pendente, antes de chamar o \fBdh_installdocs\fR.) .Sp Por favor note que esta opção apenas é aplicada ao directório de documentação para o próprio pacote. Quando o pacote embarca documentação para outro pacote (ex. veja \fB\-\-doc\-main\-package\fR), não irá usar um link simbólico para a documentação do outro pacote. .Sp \&\fB\s-1CAVEAT 1\s0\fR: Se uma versão anterior do pacote foi compilada sem esta opção e for agora compilada com ela (ou vice-versa), precisa de uma migração de dir para symlink\*(L" (ou de \*(R"symlink para dir"). Como o debhelper não tem conhecimento das versões anteriores, você terá que ser o próprio a activar esta migração. .Sp Isto pode ser feito ao fornecer um ficheiro "debian/\fIpacote\fR.maintscript" e usar o \fBdh_installdeb\fR\|(1) para fornecer os fragmentos relevantes do script do mantenedor. .Sp \&\fB\s-1CAVEAT 2\s0\fR: O uso de \fB\-\-link\-doc\fR apenas deve ser feito quando os pacotes têm o mesmo tipo de \*(L"arquitectura\*(R". Um link de um pacote independente de uma arquitectura para um pacote depende de uma arquitectura (ou vice-versa) não irá funcionar. Desde compatibilidade 10, o debhelper irá rejeitar activamente combinações não suportadas. .IP "\fIficheiro\fR ..." 4 .IX Item "ficheiro ..." Instala estes ficheiros como documentação no primeiro pacote em que se actua. (Ou em todos os pacotes se for especificado \fB\-A\fR). .SH "EXEMPLOS" .IX Header "EXEMPLOS" Este é um exemplo de um ficheiro \fIdebian/package.docs\fR: .PP .Vb 6 \& README \& TODO \& debian/notes\-for\-maintainers.txt \& docs/manual.txt \& docs/manual.pdf \& docs/manual\-html/ .Ve .SH "NOTAS" .IX Header "NOTAS" Note que \fBdh_installdocs\fR irá alegremente copiar as hierarquias completas dos directórios se você lhe pedir (semelhante a \fBcp \-a\fR). Se lhe for pedido para instalar um directório, irá instalar o conteúdo completo desse directório. .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.