Provided by: debhelper_8.9.0ubuntu1_all bug

NOMBRE

       dh_install - Instala ficheros en los directorios de construccion del
       paquete

SINOPSIS

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

DESCRIPCI'ON

       dh_install es un programa de debhelper que instala ficheros en los
       directorios de construccion del paquete. Hay muchas ordenes dh_install*
       que se encargan de instalar tipos de ficheros especificos, como
       documentacion, ejemplos, paginas de manual y mas, se deben usar siempre
       que sea posible, pues a menudo son mas habiles en estas tareas
       particulares. Asi, dh_install es util 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.

       Este programa se puede usar de dos modos. Si solo tiene uno o dos
       ficheros que el <<Makefile>> del desarrollador principal no instala,
       puede usar dh_install para moverlos a su lugar. Por otro lado, quiza
       tenga un gran paquete que construye multiples paquetes binarios. Puede
       usar el Makefile del desarrollador original para instalar todo en
       debian/tmp, y despues usar dh_install para copiar los directorios y
       ficheros desde ahi a los directorios de construccion del paquete
       adecuados.

       A partir del nivel 7 de compatibilidad de debhelper en adelante,
       dh_install buscara por omision ficheros en debian/tmp, si no los
       encuentra en el directorio actual (o en la ubicacion donde indico que
       mirase usando --sourcedir).

FICHEROS

       debian/paquete.install
           Los ficheros <<debian/paquete.install>> listan los ficheros a
           instalar en cada paquete y el directorio donde se deben instalar.
           El formato es un conjunto de lineas, cada linea lista un fichero o
           ficheros a instalar, y al final de esta 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 instalacion es relativo al directorio de construccion
           del paquete. Se pueden usar comodines en los nombres de los
           ficheros a instalar (en modo v3 o superior).

OPCIONES

       --list-missing
           Esta opcion hace que dh_install registre los ficheros que instala
           y, al final, compare esa lista con los ficheros en el directorio
           fuente. Si alguno de los ficheros (o enlaces simbolicos) en el
           directorio fuente no se instalaron en algun lugar, dara un aviso a
           traves de la salida de error estandar.

           Puede ser util si tiene un paquete grande y quiere comprobar que no
           olvida instalar ningun fichero nuevo anadido en una nueva version
           del programa.

           Tenga en cuenta de que no avisa de los ficheros excluidos mediante
           la opcion -X.

       --fail-missing
           Esta opcion es como --list-missing, excepto que si olvida un
           fichero, no solo se listaran los ficheros olvidados, sino que
           ademas se devolvera un codigo de salida distinto de cero.

       -Xelemento, --exclude=elemento
           No instala ficheros que contienen elemento en cualquier parte de su
           nombre.

       --sourcedir=directorio
           Busca en el directorio especificado los ficheros a instalar.

           Tenga en cuenta que no es igual que la opcion --sourcedirectory
           usada por las ordenes dh_auto_*. Rara vez usara esta opcion, ya que
           dh_install busca ficheros en debian/tmp con el nivel 7 de
           compatibilidad o superior.

           Nivel de compatibilidad 7 y superior.

       --autodest
           Averigua el directorio donde instalar las cosas. Si se define, no
           deberia listar los directorios de destino en los ficheros
           debian/paquete.install o en la linea de ordenes. En vez de esto,
           dh_install lo averiguara del siguiente modo:

           Si esta presente, elimina debian/tmp (o el <<sourcedir>>, si se
           proporciona) del principio del nombre del fichero, y 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
           copiara a debian/paquete/usr/. Si el nombre del fichero es
           debian/tmp/etc/passwd, se copiara a debian/paquete/etc/.

           Tenga en cuenta que si lista exactamente un nombre o patron de
           comodines en una linea en el fichero debian/paquete.install, sin
           ningun destino explicito, dh_install averiguara automaticamente el
           destino, incluso si esta opcion no se define.

       fichero ... destino
           Lista los ficheros (o directorios) a instalar y el lugar donde se
           instalaran. Los ficheros se instalaran en el primer paquete sobre
           el que actue dh_install.

EJEMPLO

       Suponga que el Makefile del desarrollador original del paquete instala
       un binario, una pagina de 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 ejecutara
       dh_install --sourcedir=debian/tmp. Cree un fichero debian/tal.install
       que contenga:

         usr/bin
         usr/share/man/man1

       Mientras que debian/libtal.install debe contener:

         usr/libtal*.so.*

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

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

LIMITACIONES

       dh_install no puede renombrar ficheros o directorios, solo puede
       instalarlos con los nombres que ya tengan en el lugar que desee en el
       arbol de construccion del paquete.

V'EASE TAMBI'EN

       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>
       Actualizacion de Omar Campagne Polaino