NOME¶
dh_installman - instala manuais (man pages) em directórios de
compilação de pacotes
RESUMO¶
dh_installman [
debhelper opções]
[
manpage ...]
DESCRIÇÃO¶
dh_installman é um programa debhelper que lida com a
instalação dos manuais (páginas man) nas
localizações correctas nos directórios de
compilação dos pacotes. Você diz-lhe quais manuais
vão para os seus pacotes, e ele descobre onde os instalar com base no
campo secção na sua linha
.TH ou
.Dt. Se
você tem uma linha
.TH ou
.Dt 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
3perl, a qual é colocada em
man3, e é-lhe dada uma extensão
.3perl). Se a sua
linha
.TH ou
.Dt está incorrecta ou em falta, o programa
pode adivinhar errado com base na extensão do ficheiro.
Também suporta manuais traduzidos, ao procurar extensões como
.ll.8 e
.ll_LL.8, ou pelo uso do switch
--language.
Se o
dh_installman 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
.TH or
.Dt.
Edite o manual e corrija a secção, e o
dh_installman
funcionará bem. Veja
man(7) para detalhes acerca da
secção
.TH, e
mdoc(7) para a secção
.Dt. Se o
dh_installman parecer instalar um manual num
directório como
/usr/share/man/pl/man1/, é porque o seu
programa tem um nome como
foo.pl, e o
dh_installman assume que
isso significa que está traduzido em Polaco. Use
--language=C
para evitar isto.
Após o passo da instalação do manual, o
dh_installman irá verificar se algum dos manuais nos
directórios temporários de todos os pacotes em que actua se
contêm links
.so. Se sim, altera-os para links
simbólicos.
O
dh_installman também irá usa o man para adivinhar a
codificação de caracteres de cada manual e convertê-los
para UTF-8. Se o trabalho de adivinhar falhar por alguma razão,
você pode-o sobrepor usando uma declaração de
codificação. Veja
manconv(1) para detalhes.
FICHEIROS¶
- debian/pacote.manpages
- Lista os manuais (man pages) a serem instalados.
OPÇÕES¶
- -A, --all
- Instala todos os ficheiros especificados pelos parâmetros de linha
de comandos em TODOS os pacotes em que actua.
- --language=ll
- Use isto para especificar que os manuais onde se vai actuar estão
escritos na linguagem especificada.
- manpage ...
- Instala estes manuais no primeiro pacote onde se actua. (Ou em todos os
pacotes caso for especificado -A).
NOTAS¶
Uma versão mais antiga deste programa, o
dh_installmanpages(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.
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.