NOMBRE

       dh_installdocs - Instala documentación en los directorios de construcción del paquete

SINOPSIS

       dh_installdocs [opciones-de-debhelper] [-A] [-Xelemento] [fichero ...]

DESCRIPCIÓN

       dh_installdocs es un programa de debhelper responsable de instalar documentación en
       usr/share/doc/paquete en los directorios de construcción del paquete.

FICHEROS

       debian/paquete.docs
           Lista los ficheros de documentación a instalar en el package.

       debian/copyright
           El fichero «copyright» se instala en todos los paquetes, a menos que se disponga de un
           fichero «copyright» más específico.

       debian/paquete.copyright
       debian/paquete.README.Debian
       debian/paquete.TODO
           Se instalará automáticamente cada uno de estos ficheros si están presentes para el
           paquete.

       debian/README.Debian
       debian/TODO
           Estos ficheros se instalan en el primer paquete binario listado en «debian/control».

           Tenga en cuenta que README.debian también se instala como README.Debian, y que TODO se
           instalará como TODO.Debian en paquetes no nativos.

       debian/paquete.doc-base
           Installed as doc-base control files. Note that the doc-id will be determined from the
           Document: entry in the doc-base control file in question. In the event that multiple
           doc-base files in a single source package share the same doc-id, they will be
           installed to usr/share/doc-base/package instead of usr/share/doc-base/doc-id.

       debian/paquete.doc-base.*
           If your package needs to register more than one document, you need multiple doc-base
           files, and can name them like this. In the event that multiple doc-base files of this
           style in a single source package share the same doc-id, they will be installed to
           usr/share/doc-base/package-* instead of usr/share/doc-base/doc-id.

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.

       -Xelemento, --exclude=elemento
           No instala ficheros que contienen elemento en cualquier lugar de su nombre. Tenga en
           cuenta que esto incluye ficheros de doc-base.

       --link-doc=paquete
           Hace que el directorio de documentación de todos los paquetes sobre los que se actúa
           sea un enlace simbólico al directorio de documentación del paquete. No tiene efecto
           cuando se actúa sobre el mismo paquete, o si el directorio de documentación a crear ya
           existe al ejecutar dh_installdocs. Para cumplir las normas, el paquete debe ser un
           paquete binario que se origina del mismo paquete fuente.

           debhelper intentará evitar instalar ficheros en directorios de documentación enlazados
           que podrían causar un conflicto con el paquete enlazado. La opción -A no tendrá efecto
           sobre los paquetes con directorios de documentación enlazados, y no se instalarán los
           ficheros copyright, changelog, README.Debian y TODO.

           (Otro método, aún permitido, es hacer del directorio de documentación un enlace
           simbólico colgante, «dangling», antes de invocar dh_installdocs.)

           CAVEAT: If a previous version of the package was built without this option and is now
           built with it (or vice-versa), it requires a "dir to symlink" (or "symlink to dir")
           migration.  Since debhelper has no knowledge of previous versions, you have to enable
           this migration itself.

           This can be done by providing a "debian/package.maintscript" file and using
           dh_installdeb(1) to provide the relevant maintainer script snippets.

       fichero ...
           Instala esos ficheros como documentación en el primer paquete sobre el que actúa (o en
           todos si se especifica -A).

EJEMPLOS

       A continuación se muestra un ejemplo de un fichero debian/paquete.docs:

         README
         TODO
         debian/notes-for-maintainers.txt
         docs/manual.txt
         docs/manual.pdf
         docs/manual-html/

NOTAS

       Tenga en cuenta que dh_installdocs copiará sin problemas jerarquías de directorio enteras
       si se le indica (similar a cp -a). Si le indica instalar un directorio instalará todos los
       contenidos de éste.

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