man/es/dh_install.pod

   1 # (c) 2003 Software in the Public Interest
   2 # Esta traducción ha sido realizada por Rubén Porras Campo <nahoo@inicia.es>
   3 # Está basada en la página de manual original:
   4 # versión 1.4 del CVS de
   5 # /cvs/debian-doc/manpages/english/debhelper/dh_install.pod
   6
   7 =head1 NOMBRE
   8
   9 dh_install - instala ficheros en los directorios de construcción del paquete
  10
  11
  12 =cut
  13
  14 =head1 SINOPSIS
  15
  16 B<dh_install> [B<-X>I<elemento>] [B<--autodest>] [B<--sourcedir=>I<dir>] [S<I<opciones debhelper>>] [S<I<fichero [...] dest>>]
  17
  18 =head1 DESCRIPCIÓN
  19
  20 dh_install es un programa de debhelper que instala ficheros en los directorios
  21 de construcción del paquete. Hay muchas órdenes dh_install* que se encargan de
  22 instalar tipos de ficheros específicos como documentación, ejemplos, páginas del
  23 manual... , debe usarse siempre que sea posible, pues a menudo son más hábiles
  24 en una tarea particular. Entonces, dh_install, es útil para instalar el resto de
  25 las cosas para las cuales no se necesita ninguna habilidad especial. Es un
  26 reemplazo de la antigua orden dh_movefiles.
  27
  28 Los ficheros debian/paquete.install listan los ficheros a instalar en cada
  29 paquete y el directorio donde deben instalarse. El formato es un conjunto de
  30 líneas, cada línea lista un fichero o ficheros a instalar, al final de ésta se
  31 encuentra el directorio donde se deben de instalar. El nombre de los ficheros (o
  32 directorios) a instalar debe ser relativo al directorio actual, mientras que el
  33 directorio de instalación es relativo al directorio de construcción del
  34 paquete. Pueden usarse comodines en los nombres de los ficheros a instalar
  35 (desde v3 en adelante).
  36
  37 Este programa puede usarse de dos modos. Si solamente tiene uno o dos ficheros
  38 que el Makefile del desarrollador principal no instala por usted, puede usar
  39 dh_install para moverlos a su lugar. Por otro lado, quizá tenga un gran paquete
  40 que construya múltiples paquetes binarios. Puede usar el Makefile del
  41 desarrollador principal para instalarlo en debian/tmp, y después usar dh_install
  42 para copiar los directorios y ficheros desde ahí a los directorios de
  43 construcción del paquete correctos.
  44
  45 =head1 OPCIONES
  46
  47 =over 4
  48
  49 =item B<-Xelemento>, B<--exclude=elemento>
  50
  51 Hace que los ficheros que contengan "elemento" en cualquier parte de su nombre
  52 no se instalen.
  53
  54 =item B<--autodest>
  55
  56 Adivina el directorio donde instalar las cosas. Si se especifica no se deben
  57 listar los directorios destino en los ficheros debian/paquete.install o en la
  58 línea de órdenes. En vez de esto, dh_install lo adivinará del siguiente modo:
  59
  60 Eliminará debian/tmp (o el sourcedir si este se proporciona) del principio del
  61 nombre, si está presente, e instala en nombre del directorio del nombre del
  62 fichero. Entonces, si el nombre del fichero es debian/tmp/usr/bin, el
  63 directorios será copiado a debian/paquete/usr/. Si el nombre del fichero es
  64 debian/tmp/etc/passwd, se copiará a debian/paquete/etc/.
  65
  66 Dese cuenta que si lista sólo un nombre en una líneas por si mismo en el fichero
  67 debian/paquete.install, sin ningún destino implícito, entonces dh_install
  68 automáticamente adivinará el destino, incluso si la no se ha usado esta opción.
  69
  70 =item B<--list-missing>
  71
  72 Esta opción hace que dh_install lleve la cuenta de los ficheros que instala, y
  73 al final, compare esa lista con los ficheros en el directorio fuente. Si alguno
  74 de los ficheros (o enlaces simbólicos) en el directorio fuente no se instalaron
  75 en algún lugar, dará un aviso a través de stderr.
  76
  77 Esto puede ser útil si tiene un paquete grande y quiere asegurarse de que no se
  78 olvida de instalar ningún fichero nuevo añadido en una nueva versión del
  79 programa.
  80
  81 Dese cuenta de que no se avisa de los fichero excluidos mediante la opción -X.
  82
  83 =item B<--fail-missing>
  84
  85 Esta opción es como --list-missing, excepto que si se olvida un fichero, no sólo
  86 se listarán los ficheros olvidados, sino que además se devolverá un código de
  87 salida distinto de cero.
  88
  89 =item B<--sourcedir=dir>
  90
  91 Hace que todos los ficheros fuente se encuentren bajo dir. Si se especifica, es
  92 parecido a anteponer "dir/" a todos los nombres de los ficheros fuente.
  93
  94 Para que dh_install se comporte similar al viejo dh_movefiles, mueva su fichero
  95 paquete.files a paquete.install y llame a dh_install con
  96 "--sourcedir=debian/tmp" añadido a la orden. Esto aproximará el comportamiento
  97 de dh_movefiles, excepto en que copiará los ficheros en vez de moverlos.
  98
  99 =item I<file [...] dest>
 100
 101 Lista los ficheros (o directorios) a instalar y el lugar donde se instalarán.
 102 Los ficheros se instalarán en el primer paquete sobre el que actúe dh_install.
 103
 104 =back
 105
 106
 107 =cut
 108
 109 =head1 EJEMPLO
 110
 111 Suponga que el Makefile del desarrollador principal del paquete instala un
 112 binario, una página del manual, y una biblioteca en los directorios apropiados
 113 de debian/tmp. Quiere poner la biblioteca en el paquete libtal, y el resto en el
 114 paquete tal. Su fichero rules ejecutará "dh_install
 115 --sourcedir=debian/tmp". Haga un debian/tal.install que contenga:
 116
 117   usr/bin
 118   usr/share/man/man1
 119
 120 Mientras que debian/libtal.install debe contener:
 121
 122   usr/libtal*.so.*
 123
 124 Si además quiere un paquete libtal-dev, debian/libtal-dev.install es posible que
 125 contenga:
 126
 127   usr/include
 128   usr/lib/libtal*.so
 129   usr/share/man/man3
 130
 131 =head1 LIMITACIONES
 132
 133 dh_install no puede renombrar ficheros o directorios, sólo puede instalarlos con
 134 los nombres que ya tengan en cualquier lugar en el árbol de construcción del
 135 paquete.
 136
 137 =head1 VÉASE TAMBIÉN
 138
 139 L<debhelper(7)>
 140
 141 Este programa es parte de debhelper.
 142
 143 =head1 AUTOR
 144
 145 Joey Hess <joeyh@debian.org>
 146
 147
 148 =head1 TRADUCTOR
 149
 150 Traducción de Rubén Porras Campo <debian-l10n-spanish@lists.debian.org>
 151
 152
 153 =cut