Provided by: debhelper_9.20120115ubuntu3_all bug

NOMBRE

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

SINOPSIS

       dh_install [-Xelemento] [--autodest] [--sourcedir=dir]
       [opcionesdebhelper] [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 de manual y más, se deben usar siempre
       que sea posible, pues a menudo son más hábiles en estas tareas
       particulares. Así, 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.

       Este programa se puede usar de dos modos. Si sólo 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, quizá
       tenga un gran paquete que construye múltiples paquetes binarios. Puede
       usar el Makefile del desarrollador original para instalar todo 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
       adecuados.

       A partir del nivel 7 de compatibilidad de debhelper en adelante,
       dh_install buscará por omisión ficheros en debian/tmp, si no los
       encuentra en el directorio actual (o en la ubicación donde indicó 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 líneas, cada línea lista un fichero o
           ficheros a instalar, y 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. Se pueden usar comodines en los nombres de los
           ficheros a instalar (en modo v3 o superior).

OPCIONES

       --list-missing
           Esta opción 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 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.

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

           Tenga en cuenta de que no avisa de los ficheros excluidos mediante
           la opción -X.

       --fail-missing
           Esta opción es como --list-missing, excepto que si 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.

       -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 opción --sourcedirectory
           usada por las órdenes dh_auto_*. Rara vez usará esta opción, ya que
           dh_install busca ficheros de forma automática en debian/tmp con el
           nivel de compatibilidad 7 y posterior.

       --autodest
           Averigua el directorio dónde instalar las cosas. Si se define, no
           debería 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 averiguará del siguiente modo:

           Si está 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
           copiará a debian/paquete/usr/. Si el nombre del fichero es
           debian/tmp/etc/passwd, se copiará a debian/paquete/etc/.

           Tenga en 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, dh_install averiguará automáticamente el
           destino, incluso si esta opción no se define.

       fichero ... destino
           Lista los ficheros (o directorios) a instalar y el lugar dónde se
           instalarán. Los ficheros se instalarán en el primer paquete sobre
           el que actúe dh_install.

LIMITACIONES

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

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