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.
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.
From debhelper compatibility level 7 on, dh_install will fall back to looking in debian/tmp for files, if it doesn’t find them in the current directory (or whereever you’ve told it to look using −−sourcedir).
FILES
debian/package.install
List the files to install into each package and the directory they should be installed to. The format is a set of lines, where each line lists a file or files to install, and at the end of the line tells the directory it should be installed in. The name of the files (or directories) to install should be given relative to the current directory, while the installation directory is given relative to the package build directory. You may use wildcards in the names of the files to install (in v3 mode and above).
OPCIONES
−−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.
−Xelemento, −−exclude=elemento
Los ficheros que contengan "elemento" en alguna parte de su nombre no se instalarán.
−−sourcedir=dir
Look in the specified directory for files to be installed.
Note that this is not the same as the −−sourcedirectory option used by the dh_auto_* commands. You rarely need to use this option, since dh_install automatically looks for files in debian/tmp in debhelper compatibility level 7 and above.
−−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.
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
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>