1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
# (c) 2003 Software in the Public Interest
# Esta traducci�n ha sido realizada por Rub�n Porras Campo <nahoo@inicia.es>
# Est� basada en la p�gina de manual original:
# versi�n 1.5 del CVS de
# /cvs/debian-doc/manpages/english/debhelper/dh_install.pod
=head1 NOMBRE
dh_install - instala ficheros en los directorios de construcci�n del paquete
=head1 SINOPSIS
B<dh_install> [B<-X>I<elemento>] [B<--autodest>] [B<--sourcedir=>I<dir>] [S<I<opciones debhelper>>] [S<I<fichero [...] dest>>]
=head1 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.
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
l�neas, cada l�nea lista un fichero o ficheros a instalar, 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. 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, 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.
=head1 OPCIONES
=over 4
=item B<-Xelemento>, B<--exclude=elemento>
Hace que los ficheros que contengan "elemento" en cualquier parte de su nombre
no se instalen.
=item B<--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.
=item B<--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.
=item B<--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.
=item B<--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" a�adido a la orden. Esto aproximar� el comportamiento
de dh_movefiles, excepto en que copiar� los ficheros en vez de moverlos.
=item I<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.
=back
=head1 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
=head1 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.
=head1 V�ASE TAMBI�N
L<debhelper(7)>
Este programa es parte de debhelper.
=head1 AUTOR
Joey Hess <joeyh@debian.org>
=head1 TRADUCTOR
Traducci�n de Rub�n Porras Campo <debian-l10n-spanish@lists.debian.org>
|
