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

9.20160115ubuntu3                                  2016-03-31                                  DH_INSTALLDOCS(1)