Linux Certif

Toute la documentation sur la certification Linux LPI

dh_install

NOMBRE

dh_install - instala ficheros en los directorios de construccion del paquete

SINOPSIS

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

DESCRIPCION

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 del manual... deben usarse siempre que sea posible, pues a menudo son mas habiles en estas tareas particulares. Entonces, 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.

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 lineas, cada linea lista un fichero o ficheros a instalar, 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. 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, quiza tenga un gran paquete que construye multiples paquetes binarios. Puede usar el Makefile del desarrollador principal para instalarlo en debian/tmp, y despues usar dh_install para copiar los directorios y ficheros desde ahi a los directorios de construccion 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 --srcdir).

OPCIONES

-Xelemento, --exclude=elemento

Los ficheros que contengan ``elemento'' en alguna parte de su nombre no se instalaran.

--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 linea de ordenes. En vez de esto, dh_install lo adivinara del siguiente modo:

Si esta presente elimina debian/tmp (o el ``sourcedir'', si se proporciona) del principio del nombre del fichero, y despues 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/.

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

--list-missing

Esta opcion 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 simbolicos) en el directorio fuente no se instalaron en algun lugar, dara un aviso a traves de la salida de error estandar.

Esto puede ser util si tiene un paquete grande y quiere asegurarse de que no se olvida de instalar ningun fichero nuevo an~adido en una nueva version del programa.

Dese cuenta de que no se avisa de los fichero excluidos mediante la opcion -X.

--fail-missing

Esta opcion es como --list-missing, excepto que si se olvida un fichero, no solo se listaran los ficheros olvidados, sino que ademas se devolvera un codigo 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'' an~adido a la orden. Esto aproximara el comportamiento de dh_movefiles, excepto en que copiara los ficheros en vez de moverlos.

file [...] dest

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 principal del paquete instala un binario, una pagina 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 ejecutara ``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 ademas 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, solo puede instalarlos con los nombres que ya tengan en cualquier lugar en el arbol de construccion del paquete.

VEASE ADEMAS

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>