Available in

(1) (1)/es (1)/fr

Contents

NOMBRE

dh_installdocs − instala documentación en los directorios de construcción

SINOPSIS

dh_installdocs [opciones debhelper] [−A] [−n] [−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.

dh_installdocs automáticamente instala debian/copyright si es que existe. Si dh_installdocs actúa en múltiples paquetes, los ficheros debian/copyright se copiarán 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 parámetro se instalará en el primer paquete sobre el que actúe dh_installdocs. Por omisión, este es el primer paquete binario en debian/control, pero si usa alguna de las opciones −p, −i, o −a, será el primer paquete especificado por estas.

Además, 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 está actuando sobre ese paquete. Note que debian/TODO se instalará con el nombre TODO .Debian si el paquete no es un paquete nativo de Debian. Además 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 instalarán como ficheros de control de doc−base, y hará que el programa genere automáticamente las órdenes de postinst y prerm necesarias para interaccionar con el paquete doc−base. Note que la doc-id se determinará de la entrada "Document:" en el fichero de control de doc-base en cuestión.

Si su paquete necesita registrar más de un documento, necesita múltiples ficheros. Para esto puede usar ficheros llamados debian/paquete.doc−base.*

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úe.

−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 documentación en el primer paquete sobre el que actúe. (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

Dese cuenta de que dh_installdocs copiará alegremente jerarquías de directorios enteras si usted lo pide (similar a −a). Si se le pide instalar un directorio instalará todos sus contenidos.

Esta orden no es idempotente. Debe llamarse a "dh_clean −k" entre invocaciones de esta orden. De otro modo, puede causar que los scripts de mantenimiento contengan partes duplicadas.

VÉASE ADEMÁS

debhelper(7)

Este programa es parte de debhelper.

AUTOR

Joey Hess <joeyh [AT] debian.org>

TRADUCTOR

Traducción de Rubén Porras Campo <debian−l10n−spanish [AT] lists.org>

COMMENTS

blog comments powered by Disqus