Provided by: debhelper_5.0.7ubuntu13_all bug

NOMBRE

       dh_install - instala ficheros en los directorios de construcción del
       paquete

SINOPSIS

       dh_install [-Xelemento] [--autodest] [--sourcedir=dir]
       [opciones debhelper] [fichero [...] dest]

DESCRIPCIÓN

       dh_install es un programa de debhelper que instala ficheros en los
       directorios de construcción del paquete. Hay muchas órdenes dh_install*
       que se encargan de instalar tipos de ficheros específicos, como
       documentación, ejemplos, páginas del manual... deben usarse siempre que
       sea posible, pues a menudo son más hábiles en estas tareas
       particulares. Entonces, dh_install, es útil para instalar el resto de
       las cosas para las cuales no se necesite ninguna habilidad especial. Es
       un reemplazo de la antigua orden dh_movefiles.

       Los ficheros debian/paquete.install listan los ficheros a instalar en
       cada paquete y el directorio donde deben instalarse. El formato es un
       conjunto de líneas, cada línea lista un fichero o ficheros a instalar,
       al final de ésta se encuentra el directorio donde se deben instalar. El
       nombre de los ficheros (o directorios) a instalar debe ser relativo al
       directorio actual, mientras que el directorio de instalación es
       relativo al directorio de construcción del paquete. Puede usarse
       comodines en los nombres de los ficheros a instalar (en modo v3 o
       superior).

       Este programa puede usarse de dos modos. Si solamente tiene uno o dos
       ficheros que el Makefile del desarrollador principal no instala por
       usted, puede usar dh_install para moverlos a su lugar. Por otro lado,
       quizá tenga un gran paquete que construye múltiples paquetes binarios.
       Puede usar el Makefile del desarrollador principal para instalarlo en
       debian/tmp, y después usar dh_install para copiar los directorios y
       ficheros desde ahí a los directorios de construcción del paquete
       correctos.

OPCIONES

       -Xelemento, --exclude=elemento
           Los ficheros que contengan "elemento" en alguna parte de su nombre
           no se instalarán.

       --autodest
           Adivina el directorio donde instalar las cosas. Si se especifica no
           se deben listar los directorios de destino en los ficheros
           debian/paquete.install o en la línea de órdenes. En vez de esto,
           dh_install lo adivinará del siguiente modo:

           Si está presente elimina debian/tmp (o el "sourcedir", si se
           proporciona) del principio del nombre del fichero, y después lo
           instala en el directorio que forma parte del nombre del fichero.
           Esto es, si el nombre del fichero es debian/tmp/usr/bin, el
           directorio se copiará a debian/paquete/usr/. Si el nombre del
           fichero es debian/tmp/etc/passwd, se copiará a debian/paquete/etc/.

           Dese cuenta que si lista exactamente un nombre o patrón de
           comodines en una línea en el fichero debian/paquete.install, sin
           ningún destino explícito, entonces dh_install adivinará
           automáticamente el destino, incluso si no se ha usado esta opción.

       --list-missing
           Esta opción hace que dh_install lleve la cuenta de los ficheros que
           instala, y al final, compare esa lista con los ficheros en el
           directorio fuente. Si alguno de los ficheros (o enlaces simbólicos)
           en el directorio fuente no se instalaron en algún lugar, dará un
           aviso a través de la salida de error estándar.

           Esto puede ser útil si tiene un paquete grande y quiere asegurarse
           de que no se olvida de instalar ningún fichero nuevo añadido en una
           nueva versión del programa.

           Dese cuenta de que no se avisa de los fichero excluidos mediante la
           opción -X.

       --fail-missing
           Esta opción es como --list-missing, excepto que si se olvida un
           fichero, no sólo se listarán los ficheros olvidados, sino que
           además se devolverá un código de salida distinto de cero.

       --sourcedir=dir
           Hace que todos los ficheros fuente se encuentren bajo dir. Si se
           especifica, es parecido a anteponer "dir/" a todos los nombres de
           los ficheros fuente.

           Para que dh_install se comporte similar al viejo dh_movefiles,
           mueva su fichero paquete.files a paquete.install y llame a
           dh_install con "--sourcedir=debian/tmp" añadido a la orden. Esto
           aproximará el comportamiento de dh_movefiles, excepto en que
           copiará los ficheros en vez de moverlos.

       file [...] dest
           Lista los ficheros (o directorios) a instalar y el lugar donde se
           instalarán.  Los ficheros se instalarán en el primer paquete sobre
           el que actúe dh_install.

EJEMPLO

       Suponga que el Makefile del desarrollador principal del paquete instala
       un binario, una página del manual, y una biblioteca en los directorios
       apropiados de debian/tmp. Quiere poner la biblioteca en el paquete
       libtal, y el resto en el paquete tal. Su fichero rules ejecutará
       "dh_install --sourcedir=debian/tmp". Haga un debian/tal.install que
       contenga:

         usr/bin
         usr/share/man/man1

       Mientras que debian/libtal.install debe contener:

         usr/libtal*.so.*

       Si además quiere un paquete libtal-dev, debian/libtal-dev.install es
       posible que contenga:

         usr/include
         usr/lib/libtal*.so
         usr/share/man/man3

LIMITACIONES

       dh_install no puede renombrar ficheros o directorios, sólo puede
       instalarlos con los nombres que ya tengan en cualquier lugar en el
       árbol de construcción del paquete.

VÉASE ADEMÁS

       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>