Linux Certif

Toute la documentation sur la certification Linux LPI

dh_installdocs

NOMBRE

dh_installdocs - instala documentacion en los directorios de construccion

SINOPSIS

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

DESCRIPCION

dh_installdocs es un programa de debhelper responsable de instalar documentacion en usr/share/doc/paquete en los directorios de construccion del paquete.

dh_installdocs automaticamente instala debian/copyright si es que existe. Si dh_installdocs actua en multiples paquetes, los ficheros debian/copyright se copiaran en todos ellos. Sin embargo, si necesita tener un fichero copyright separado para cada paquete binario, puede usar ficheros llamados debian/paquete.copyright.

Cualquier fichero especificado como parametro se instalara en el primer paquete sobre el que actue dh_installdocs. Por omision, este es el primer paquete binario en debian/control, pero si usa alguna de las opciones -p, -i, o -a, sera el primer paquete especificado por estas.

Ademas, debian/README.Debian (o debian/README.debian) y debian/TODO, si existen, se instalan en el primer paquete binario listado en debian/control, si dh_installdocs esta actuando sobre ese paquete. Note que debian/TODO se instalara con el nombre TODO.Debian si el paquete no es un paquete nativo de Debian. Ademas dese cuenta que README.debian se instala como README.Debian, por consistencia. Tenga en cuenta que debian/paquete.README.Debian y debian/paquete.TODO pueden usarse para especificar ficheros para subpaquetes.

Los ficheros debian/paquete.docs pueden listar otros ficheros a instalar.

Los ficheros debian/paquete.doc-base, se instalaran como ficheros de control de doc-base, y hara que el programa genere automaticamente las ordenes de postinst y prerm necesarias para interaccionar con el paquete doc-base. Note que la doc-id se determinara de la entrada ``Document:'' en el fichero de control de doc-base en cuestion.

Si su paquete necesita registrar mas de un documento, necesita multiples ficheros. Para esto puede usar ficheros llamados debian/paquete.doc-base.*

OPCIONES

-A, --all

Instala todos los ficheros especificados en los parametros de la linea de ordenes en TODOS los paquetes sobre los que actue.

-n, --noscripts

No modifica los scripts de postinst/prerm.

-Xelemento, --exclude=elemento

Exclude files that contain ``item'' anywhere in their filename from being installed. Note that this includes doc-base files.

fichero ...

Instala esos ficheros como documentacion en el primer paquete sobre el que actue. (O en todos si se especifica -A).

EJEMPLOS

A continuacion 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

Dese cuenta de que dh_installdocs copiara alegremente jerarquias de directorios enteras si usted lo pide (similar a -a). Si se le pide instalar un directorio instalara todos sus contenidos.

Note that this command is not idempotent. dh_prep(1) should be called between invocations of this command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.

VEASE ADEMAS

debhelper(7)

Este programa es parte de debhelper.

AUTOR

Joey Hess <joeyh@debian.org>

TRADUCTOR

Traduccion de Ruben Porras Campo <debian-l10n-spanish@lists.debian.org>