SINOPSIS

dh_installman [opciones-de-debhelper] [página-de-manual ...]

DESCRIPCIÓN

dh_installman es un programa de debhelper que instala páginas de manual en los lugares correctos de los directorios de construcción del paquete. Usted le indica qué páginas de manual se incluyen en los paquetes, y se encargará de averiguar dónde se deben instalar en base al campo de la sección de su línea .TH o .Dt. Si tiene una línea .TH o .Dt con un formato correcto, su página de manual se instalará en el lugar correcto, con el nombre correcto (esto incluye un manejo correcto de páginas con subsecciones, como 3perl, las cuales se colocan en man3, y se les da la extensión .3perl). Si su línea .TH o .Dt es incorrecta o no esté presente, probablemente lo averigüe mal basándose en la extensión.

También acepta páginas de manual traducidas, buscando extensiones como .ll.8 y .ll_LL.8, o mediante el uso de la opción «--language».

Si parece que dh_installman instala una página de manual en una sección incorrecta o con la extensión equivocada es porque la página de manual tiene una sección incorrecta en su línea .TH o .Dt. Edite la página de manual y corrija la sección, y dh_installman hará lo correcto. Para más detalles acerca de la sección .TH, consulte man(7) y consulte mdoc(7) para la sección .Dt. Si parece que dh_installman instala la página de manual en un directorio como /usr/share/man/pl/man1/, es porque su programa tiene un nombre como tal.pl, y dh_installman asume que significa que está traducida al polaco. Para evitar esto, utilice --language=C.

Después del paso de instalación de la página de manual, dh_installman comprobará si alguna de las páginas de manual en los directorios temporales de cualquiera de los paquetes sobre los que está actuando contienen enlaces «.so». Si es así, los cambia por enlaces simbólicos.

Así mismo, dh_installman utilizará man para averiguar la codificación de caracteres de cada página de manual, y lo convertirá a UTF-8. Si no logra averiguarlo por alguna razón, puede anularlo utilizando una declaración de codificación. Para más detalles consulte manconv(1).

FICHEROS

debian/paquete.manpages

Lista las páginas de manual a instalar.

OPCIONES

-A, --all

Instala todos los ficheros especificados en los parámetros de la línea de órdenes en TODOS los paquetes sobre los que actúa.

--language=ll

Use esto para definir que el idioma que las páginas de manual sobre las que se actúa están escritas en el idioma especificado.

página-de-manual ...

Instala estas páginas de manual en el primer paquete sobre el que actúe (o en todos si se define -A).

NOTAS

Una versión anterior de este programa, dh_installmanpages(1), todavía es utilizado por algunos paquetes, y por eso se sigue incluyendo en debhelper. Sin embargo, su uso se desaconseja debido a que tiene un interfaz poco intuitiva e inconsistente. Use este programa en su lugar.

AUTOR

Joey Hess <[email protected]>

TRADUCTOR

Traducci�n de Rub�n Porras Campo <[email protected]> Actualizaci�n de Omar Campagne Polaino