.\" 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_INSTALLMAN 1" .TH DH_INSTALLMAN 1 "2021-03-06" "13.3.3~bpo10+1" "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_installman \- instala manuais (man pages) em directórios de compilação de pacotes .SH "RESUMO" .IX Header "RESUMO" \&\fBdh_installman\fR [\fIdebhelper opções\fR] [\fImanpage\fR ...] .SH "DESCRIÇÃO" .IX Header "DESCRIÇÃO" \&\fBdh_installman\fR é um programa debhelper que lida com a instalação de paginas de manual (man pages) nas localizações correctas nos directórios de compilação de pacotes. .PP Em compatibilidade 10 e anteriores, este programa servia principalmente para quando o sistema de compilação do autor não os instalava apropriadamente como uma parte do seu passo de instalação (ou não possuía um passo de instalação). Em compatibilidade 11 e posterior, também suporta o predefinido searchdir plus \-\-sourcedir como \fBdh_install\fR\|(1) e tem a vantagem de respeitar o perfil de compilação nodoc (ao contrário de \fBdh_install\fR\|(1)). .PP Mesmo que prefira usar \fBdh_install\fR\|(1) para instalar os manuais, o \&\fBdh_installman\fR pode ainda ser útil para converter a codificação da pagina de manual para \s-1UTF\-8\s0 e para converter links \fI.so\fR (como descrito abaixo). No entanto, essa parte acontece automaticamente sem nenhuma configuração explícita. .PP Você diz ao \fBdh_installman\fR quais manuais vão para os seus pacotes, e ele descobre onde os instalar com base no campo secção na sua linha \fB.TH\fR ou \&\fB.Dt\fR. Se você tem uma linha \fB.TH\fR ou \fB.Dt\fR correctamente formatada, o seu manual será instalado no directório correcto, com o nome correcto (isto inclui o manuseamento apropriado de páginas com uma sub\-secção, como \&\fB3perl\fR, a qual é colocada em \fIman3\fR, e é\-lhe dada uma extensão \&\fI.3perl\fR). Se a sua linha \fB.TH\fR ou \fB.Dt\fR está incorrecta ou em falta, o programa pode adivinhar errado com base na extensão do ficheiro. .PP Também suporta manuais traduzidos, ao procurar extensões como \fI.ll.8\fR e \&\fI.ll_LL.8\fR, ou pelo uso do switch \fB\-\-language\fR. .PP Se o \fBdh_installman\fR parecer instalar um manual numa secção errada ou com a extensão errada, é porque o manual tem a secção errada listada nas suas linhas \fB.TH\fR or \fB.Dt\fR. Edite o manual e corrija a secção, e o \&\fBdh_installman\fR funcionará bem. Veja \fBman\fR\|(7) para detalhes acerca da secção \fB.TH\fR, e \fBmdoc\fR\|(7) para a secção \fB.Dt\fR. Se o \fBdh_installman\fR parecer instalar um manual num directório como \fI/usr/share/man/pl/man1/\fR, é porque o seu programa tem um nome como \fIfoo.pl\fR, e o \fBdh_installman\fR assume que isso significa que está traduzido em Polaco. Use \fB\-\-language=C\fR para evitar isto. .PP Após o passo da instalação do manual, o \fBdh_installman\fR irá verificar se algum dos manuais nos directórios temporários de todos os pacotes em que actua se contêm links \fI.so\fR. Se sim, altera-os para links simbólicos. .PP O \fBdh_installman\fR também irá usa o man para adivinhar a codificação de caracteres de cada manual e convertê\-los para \s-1UTF\-8.\s0 Se o trabalho de adivinhar falhar por alguma razão, você pode-o sobrepor usando uma declaração de codificação. Veja \fBmanconv\fR\|(1) para detalhes. .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). .SH "FICHEIROS" .IX Header "FICHEIROS" .IP "debian/\fIpacote\fR.manpages" 4 .IX Item "debian/pacote.manpages" Lista os manuais (man pages) a serem instalados. .Sp Suporta variáveis de substituição em compatibilidade 13 e posterior como documentado em \fBdebhelper\fR\|(7). .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\-\-language=\fR\fIll\fR" 4 .IX Item "--language=ll" Use isto para especificar que os manuais onde se vai actuar estão escritos na linguagem especificada. .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 "\fImanpage\fR ..." 4 .IX Item "manpage ..." Instala estes manuais no primeiro pacote onde se actua. (Ou em todos os pacotes caso for especificado \fB\-A\fR). .SH "EXEMPLOS" .IX Header "EXEMPLOS" Um exemplo de ficheiro \fIdebian/manpages\fR poderá parecer como isto: .PP .Vb 9 \& doc/man/foo.1 \& # Translations \& doc/man/foo.da.1 \& doc/man/foo.de.1 \& doc/man/foo.fr.1 \& # NB: The following line is considered a polish translation \& # of "foo.1" (and not a manpage written in perl called "foo.pl") \& doc/man/foo.pl.1 \& # ... .Ve .SH "NOTAS" .IX Header "NOTAS" Uma versão mais antiga deste programa, o \fBdh_installmanpages\fR\|(1), é ainda usado por alguns pacotes, e por isso ainda é incluída no debhelper. No entanto, está descontinuada, devido à sua interface contra-intuitiva e inconsistente. Use antes este programa. .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.