229 lines
7.3 KiB
HTML
229 lines
7.3 KiB
HTML
|
||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<HTML><HEAD><TITLE>Man page of DH_INSTALLMAN</TITLE>
|
||
</HEAD><BODY>
|
||
<H1>DH_INSTALLMAN</H1>
|
||
Section: Debhelper (1)<BR>Updated: 2020-03-27<BR><A HREF="#index">Index</A>
|
||
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<A NAME="lbAB"> </A>
|
||
<H2>NOME</H2>
|
||
|
||
|
||
|
||
dh_installman - instala manuais (man pages) em directórios de compilação de
|
||
pacotes
|
||
<A NAME="lbAC"> </A>
|
||
<H2>RESUMO</H2>
|
||
|
||
|
||
|
||
<B>dh_installman</B> [<I>debhelper opções</I>] [<I>manpage</I> ...]
|
||
<A NAME="lbAD"> </A>
|
||
<H2>DESCRIÇÃO</H2>
|
||
|
||
|
||
|
||
<B>dh_installman</B> é 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.
|
||
<P>
|
||
|
||
In compat 10 and earlier, this program was primarily for when upstream's
|
||
build system does not properly install them as a part of its install step
|
||
(or it does not have an install step). In compat 11 and later, it also
|
||
supports the default searchdir plus --sourcedir like <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) and has
|
||
the advantage that it respects the nodoc build profile (unlike
|
||
<B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1)).
|
||
<P>
|
||
|
||
Mesmo que prefira usar <B><A HREF="/cgi-bin/man/man2html?1+dh_install">dh_install</A></B>(1) para instalar os manuais, o
|
||
<B>dh_installman</B> pode ainda ser útil para converter a codificação da pagina
|
||
de manual para <FONT SIZE="-1">UTF-8</FONT> e para converter links <I>.so</I> (como descrito
|
||
abaixo). No entanto, essa parte acontece automaticamente sem nenhuma
|
||
configuração explícita.
|
||
<P>
|
||
|
||
Você diz ao <B>dh_installman</B> quais manuais vão para os seus pacotes, e ele
|
||
descobre onde os instalar com base no campo secção na sua linha <B>.TH</B> ou
|
||
<B>.Dt</B>. Se você tem uma linha <B>.TH</B> ou <B>.Dt</B> 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
|
||
<B>3perl</B>, a qual é colocada em <I>man3</I>, e é-lhe dada uma extensão
|
||
<I>.3perl</I>). Se a sua linha <B>.TH</B> ou <B>.Dt</B> está incorrecta ou em falta, o
|
||
programa pode adivinhar errado com base na extensão do ficheiro.
|
||
<P>
|
||
|
||
Também suporta manuais traduzidos, ao procurar extensões como <I>.ll.8</I> e
|
||
<I>.ll_LL.8</I>, ou pelo uso do switch <B>--language</B>.
|
||
<P>
|
||
|
||
Se o <B>dh_installman</B> 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 <B>.TH</B> or <B>.Dt</B>. Edite o manual e corrija a secção, e o
|
||
<B>dh_installman</B> funcionará bem. Veja <B><A HREF="/cgi-bin/man/man2html?7+man">man</A></B>(7) para detalhes acerca da
|
||
secção <B>.TH</B>, e <B><A HREF="/cgi-bin/man/man2html?7+mdoc">mdoc</A></B>(7) para a secção <B>.Dt</B>. Se o <B>dh_installman</B>
|
||
parecer instalar um manual num directório como <I>/usr/share/man/pl/man1/</I>, é
|
||
porque o seu programa tem um nome como <I>foo.pl</I>, e o <B>dh_installman</B>
|
||
assume que isso significa que está traduzido em Polaco. Use <B>--language=C</B>
|
||
para evitar isto.
|
||
<P>
|
||
|
||
Após o passo da instalação do manual, o <B>dh_installman</B> irá verificar se
|
||
algum dos manuais nos directórios temporários de todos os pacotes em que
|
||
actua se contêm links <I>.so</I>. Se sim, altera-os para links simbólicos.
|
||
<P>
|
||
|
||
O <B>dh_installman</B> também irá usa o man para adivinhar a codificação de
|
||
caracteres de cada manual e convertê-los para <FONT SIZE="-1">UTF-8.</FONT> Se o trabalho de
|
||
adivinhar falhar por alguma razão, você pode-o sobrepor usando uma
|
||
declaração de codificação. Veja <B><A HREF="/cgi-bin/man/man2html?1+manconv">manconv</A></B>(1) para detalhes.
|
||
<P>
|
||
|
||
Desde nível de compatibilidade 11 do debhelper em diante, o <B>dh_install</B>
|
||
irá procurar os ficheiros em <I>debian/tmp</I>, se não os encontrar no
|
||
directório actual (ou onde você o mandou procurar usando <B>--sourcedir</B>).
|
||
<A NAME="lbAE"> </A>
|
||
<H2>FICHEIROS</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="1">debian/<I>pacote</I>.manpages<DD>
|
||
|
||
|
||
Lista os manuais (man pages) a serem instalados.
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Supports substitution variables in compat 13 and later as documented in
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7).
|
||
</DL>
|
||
<A NAME="lbAF"> </A>
|
||
<H2>OPÇÕES</H2>
|
||
|
||
|
||
|
||
<DL COMPACT>
|
||
<DT id="2"><B>-A</B>, <B>--all</B><DD>
|
||
|
||
|
||
Instala todos os ficheiros especificados pelos parâmetros de linha de
|
||
comandos em <FONT SIZE="-1">TODOS</FONT> os pacotes em que actua.
|
||
<DT id="3"><B>--language=</B><I>ll</I><DD>
|
||
|
||
|
||
Use isto para especificar que os manuais onde se vai actuar estão escritos
|
||
na linguagem especificada.
|
||
<DT id="4"><B>--sourcedir=</B><I>directório</I><DD>
|
||
|
||
|
||
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).
|
||
|
||
|
||
<P>
|
||
|
||
|
||
Note que isto não é o mesmo que a opção <B>--sourcedirectory</B> usada pelos
|
||
comandos <B>dh_auto_</B><I>*</I>. Você raramente vai precisar de usar esta opção,
|
||
pois o <B>dh_installman</B> procura automaticamente por ficheiros em
|
||
<I>debian/tmp</I> no nível de compatibilidade 11 e superiores do debhelper.
|
||
<DT id="5"><I>manpage</I> ...<DD>
|
||
|
||
|
||
Instala estes manuais no primeiro pacote onde se actua. (Ou em todos os
|
||
pacotes caso for especificado <B>-A</B>).
|
||
</DL>
|
||
<A NAME="lbAG"> </A>
|
||
<H2>EXEMPLOS</H2>
|
||
|
||
|
||
|
||
Um exemplo de ficheiro <I>debian/manpages</I> poderá parecer como isto:
|
||
<P>
|
||
|
||
|
||
|
||
<PRE>
|
||
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
|
||
# ...
|
||
|
||
</PRE>
|
||
|
||
|
||
<A NAME="lbAH"> </A>
|
||
<H2>NOTAS</H2>
|
||
|
||
|
||
|
||
Uma versão mais antiga deste programa, o <B><A HREF="/cgi-bin/man/man2html?1+dh_installmanpages">dh_installmanpages</A></B>(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.
|
||
<A NAME="lbAI"> </A>
|
||
<H2>VEJA TAMBÉM</H2>
|
||
|
||
|
||
|
||
<B><A HREF="/cgi-bin/man/man2html?7+debhelper">debhelper</A></B>(7)
|
||
<P>
|
||
|
||
Este programa é parte do debhelper.
|
||
<A NAME="lbAJ"> </A>
|
||
<H2>AUTOR</H2>
|
||
|
||
|
||
|
||
Joey Hess <<A HREF="mailto:joeyh@debian.org">joeyh@debian.org</A>>
|
||
<A NAME="lbAK"> </A>
|
||
<H2>TRADUÇÃO</H2>
|
||
|
||
|
||
|
||
Américo Monteiro
|
||
<P>
|
||
|
||
Se encontrar algum erro na tradução deste documento, por favor comunique para
|
||
Américo Monteiro <I><A HREF="mailto:a_monteiro@gmx.com">a_monteiro@gmx.com</A></I>
|
||
ou
|
||
Equipa Debian de Tradução Portuguesa <I><A HREF="mailto:traduz@debianpt.org">traduz@debianpt.org</A></I>.
|
||
<P>
|
||
|
||
<HR>
|
||
<A NAME="index"> </A><H2>Index</H2>
|
||
<DL>
|
||
<DT id="6"><A HREF="#lbAB">NOME</A><DD>
|
||
<DT id="7"><A HREF="#lbAC">RESUMO</A><DD>
|
||
<DT id="8"><A HREF="#lbAD">DESCRIÇÃO</A><DD>
|
||
<DT id="9"><A HREF="#lbAE">FICHEIROS</A><DD>
|
||
<DT id="10"><A HREF="#lbAF">OPÇÕES</A><DD>
|
||
<DT id="11"><A HREF="#lbAG">EXEMPLOS</A><DD>
|
||
<DT id="12"><A HREF="#lbAH">NOTAS</A><DD>
|
||
<DT id="13"><A HREF="#lbAI">VEJA TAMBÉM</A><DD>
|
||
<DT id="14"><A HREF="#lbAJ">AUTOR</A><DD>
|
||
<DT id="15"><A HREF="#lbAK">TRADUÇÃO</A><DD>
|
||
</DL>
|
||
<HR>
|
||
This document was created by
|
||
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
||
using the manual pages.<BR>
|
||
Time: 00:06:21 GMT, March 31, 2021
|
||
</BODY>
|
||
</HTML>
|