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
|
# (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.2 del CVS de
# /cvs/debian-doc/manpages/english/debhelper/dh_installdocs.pod
=head1 NOMBRE
dh_installdocs - instala documentaci�n en los directorios de construcci�n
=head1 SINOPSIS
B<dh_installdocs> [S<I<opciones debhelper>>] [B<-A>] [B<-n>] [B<-X>I<elemento>] [S<I<fichero ...>>]
=head1 DESCRIPCI�N
dh_installdocs es un programa de debhelper responsable de instalar documentaci�n
en usr/share/doc/paquete en los directorios de construcci�n del paquete.
dh_installdocs autom�ticamente instala debian/copyright si es que existe. Si
dh_installdocs act�a en m�ltiples paquetes, los ficheros debian/copyright se
copiar�n en todos ellos. Sin embargo, si necesita tener un fichero copyright
separado para cada paquete binario, puede usar ficheros llamados
debian/paquete.copyright.
Cualquier fichero especificado como par�metro se instalar� en el primer paquete
sobre el que act�e dh_installdocs. Por omisi�n, este es el primer paquete
binario en debian/control, pero si usa alguna de las opciones B<-p>, B<-i>, o
B<-a>, ser� el primer paquete especificado por estas.
Adem�s, debian/README.Debian (o debian/README.debian) y debian/TODO, si existen,
se instalan en el primer paquete binario listado en debian/control, si
dh_installdocs est� actuando sobre ese paquete. Note que debian/TODO se
instalar� con el nombre TODO.Debian si el paquete no es un paquete nativo de
Debian. Adem�s dese cuenta que README.debian se instala como README.Debian, por
consistencia. Tenga en cuenta que debian/paquete.README.Debian y
debian/paquete.TODO pueden usarse para especificar ficheros para subpaquetes.
Los ficheros debian/paquete.docs pueden listar otros ficheros a instalar.
Los ficheros debian/paquete.doc-base, se instalar�n como ficheros de control de
doc-base, y har� que el programa genere autom�ticamente las �rdenes de postinst
y prerm necesarias para interaccionar con el paquete doc-base. Note que la
doc-id se determinar� de la entrada "Document:" en el fichero de control de
doc-base en cuesti�n.
Si su paquete necesita registrar m�s de un documento, necesita m�ltiples
ficheros. Para esto puede usar ficheros llamados debian/paquete.doc-base.*
=head1 OPCIONES
=over 4
=item B<-A>, B<--all>
Instala todos los ficheros especificados en los par�metros de la l�nea de
�rdenes en TODOS los paquetes sobre los que act�e.
=item B<-n>, B<--noscripts>
No modifica los scripts de postinst/prerm.
=item B<-Xelemento>, B<--exclude=elemento>
Los ficheros que contengan "elemento" en alguna parte de su nombre no se
instalar�n.
=item I<fichero ...>
Instala esos ficheros como documentaci�n en el primer paquete sobre el que
act�e. (O en todos si se especifica B<-A>).
=back
=head1 EJEMPLOS
A continuaci�n se muestra un ejemplo de un fichero debian/paquete.docs:
README
TODO
debian/notes-for-maintainers.txt
docs/manual.txt
docs/manual.pdf
docs/manual-html/
=head1 NOTAS
Dese cuenta de que dh_installdocs copiar� alegremente jerarqu�as de directorios
enteras si usted lo pide (similar a -a). Si se le pide instalar un directorio
instalar� todos sus contenidos.
Esta orden no es idempotente. Debe llamarse a "dh_clean -k" entre invocaciones
de esta orden. De otro modo, puede causar que los scripts de mantenimiento
contengan partes duplicadas.
=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>
|
