NOMBRE¶

dh_installman - Instala páginas de manual en los directorios de construcción del paquete

SINOPSIS¶

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

DESCRIPCIÓN¶

dh_installman is a debhelper program that handles installing man pages into the correct locations in package build directories 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).

If upstream's installs the manpages in the proper directories, dh_install(1) may be easier to use for deciding which package should ship the manpages. In this case, dh_installman can still be useful for converting the manpage encoding to UTF-8 and for converting .so links (as described below). However, that part happens automatically without any explicit configuration.

You tell it what man pages go in your packages, and it figures out where to install them based on the section field in their .TH or .Dt line. If you have a properly formatted .TH or .Dt line, your man page will be installed into the right directory, with the right name (this includes proper handling of pages with a subsection, like 3perl, which are placed in man3, and given an extension of .3perl). If your .TH or .Dt line is incorrect or missing, the program may guess wrong based on the file extension.

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).

EJEMPLOS¶

An example debian/manpages file could look like this:

  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
  # ...

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.

VÉASE TAMBIÉN¶

debhelper(7)

Este programa es parte de debhelper.

AUTOR¶

Joey Hess <joeyh@debian.org>

TRADUCTOR¶

Traducci�n de Rub�n Porras Campo <debian-l10n-spanish@lists.debian.org> Actualizaci�n de Omar Campagne Polaino