NOMBRE

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

SINOPSIS

       dh_install [-Xelemento] [--autodest] [--sourcedir=directorio] [opciones-de-debhelper]
       [fichero|directorio [...] directorio-de-destino]

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
       utilizar 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 utilizar de dos modos. Si sólo tiene uno o dos ficheros que el
       «Makefile» del desarrollador principal no instala, puede utilizar dh_install para moverlos
       a su lugar. Por otro lado, quizá tenga un gran paquete que construye múltiples paquetes
       binarios. Puede utilizar el Makefile del desarrollador original para instalar todo en
       debian/tmp, y después utilizar 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 utilizando --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 utilizar comodines en los nombres
           de los ficheros a instalar (en modo v3 o superior).

           Tenga en cuenta que si lista exactamente un nombre de fichero o patrón de comodines en
           una sola línea, sin ningún destino explícito, dh_install averiguará automáticamente el
           destino, al igual que si se utiliza la opción «--autodest».

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 utilizada por las
           órdenes dh_auto_*. Rara vez utilizará 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/.

       fichero|destino ... directorio-de-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