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 dh_install(1) and has the advantage that it respects the nodoc build profile (unlike dh_install(1)).
Mesmo que prefira usar dh_install(1) para instalar os manuais, o dh_installman pode ainda ser útil para converter a codificação da pagina de manual para UTF-8 e para converter links .so (como descrito abaixo). No entanto, essa parte acontece automaticamente sem nenhuma configuração explícita.
Você diz ao dh_installman 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.
Desde nível de compatibilidade 11 do debhelper em diante, o dh_install irá procurar os ficheiros em debian/tmp, se não os encontrar no directório actual (ou onde você o mandou procurar usando --sourcedir).
Note que isto não é o mesmo que a opção --sourcedirectory usada pelos comandos dh_auto_*. Você raramente vai precisar de usar esta opção, pois o dh_installman procura automaticamente por ficheiros em debian/tmp no nível de compatibilidade 11 e superiores do debhelper.
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 # ...
Este programa é parte do debhelper.
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.