[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

debhelper para revisar



Para que sea más facil de revisar he destacado las partes sobre las que
tengo dudas así:
****es algo dudoso****
las resumo:

I: move files out of debian/tmp into subpackages
E: mueve los archivos de debian/tmp **a subpaqetes**
	¿quizá a los respectivos directorios debian/<paquete>?
I: strip ejecutables
E: Ni idea de como traducir strip

I: -Xitem, --exclude=item
	Exclude an item from porcessing
E: -Xarticulo --exclude=articulo
	No procesar un articulo
		¿Quizá mejor cambiar artículo por paquete?
I: binary-arch debian/rules target
E: Ni idea

I: substvar called ${misc:Depends}
E: variable sustituible llamada ${misc:Depends}

I: globbing via * and ?
E: comodines como * y ?

I: dh_installinit uses invoke-rc.d in its generates mantainer scripts
E:      "	 usará invoke-rc.d en sus scripts de mantenimiento 	generados

I: dangling link
E: enlace colgante
	Es la traduccion litera, pero no tiene sentido en el texto
I: modifies files on the build system
E: modifiquen ficheros en sistema ¿construido o mejor en construcción?
-- 
The chains are broken and the door is open wide
Our eyes adjusting to the light that was denied
And the voices ringing out now
Sing of freedom
And bring a sense of wonder

	http://www.es.debian.org/intro/about.es.html
.\" Automatically generated by Pod::Man v1.3, Pod::Parser v1.13
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sh \" Subsection heading
.br
.if t .Sp
.ne 5
.PP
\fB\\$1\fR
.PP
..
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R

.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  | will give a
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
.\" expand to `' in nroff, nothing in troff, for use with C<>.
.tr \(*W-|\(bv\*(Tr
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'br\}
.\"
.\" If the F register is turned on, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.if \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.\"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.hy 0
.if n .na
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "DEBHELPER 1"
.TH DEBHELPER 1 "2002-04-11" "4.0.2" "Debhelper"
.UC
.SH "NOMBRE"
debhelper \- El conjunto de herramientas debhelper
.SH "SINOPSIS"
.IX Header "SINOPSIS"
\&\fBdh_\fR\fI*\fR [\fB\-v\fR] [\fB\-a\fR] [\fB\-i\fR] [\fB\-s\fR] [\fB\-\-no\-act\fR] [\fB\-ppaquete\fR] [\fB\-Npaquete] [\-Ptmpdir\fR]
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
Debhelper ayuda a construir un paquete de Debian. La filosofía que se esconde
detrás de Debhelper es una colección de herramientas pequeñas, simples y fáciles
de entender y que son usadas en debian/rules para automatizar varios aspectos
comunes a la hora de construir un paquete. Esto hace que tú, el empaquetador,
tengas menos trabajo. Además si cambia la política de Debian, los paquetes que
necesiten cambios sólo necesitan ser reconstruidos para que se ajusten a la 
nueva política.
.PP
Un típico fichero debian/rules que use debhelper hará varias llamadas
en cadena a comandos de debhelper . Los comandos de debhelper tienen
todos el prefijo \*(L"dh_\*(R". Ejemplos de ficheros rules que usan
debhelper se  pueden encontrar en \&\fI/usr/share/doc/debhelper/examples/\fR
.PP
Para crear un nuevo paquete de Debian usando debhelper, simplemente puedes copiar
uno de los ficheros rules de ejemplo y editarlo a mano, o usar el paquete dh-make
que contiene el comando dh_make que automatiza parcialmente el
proceso. Para una introducción más apropiada el paquete maint-guide
contiene un tutorial acerca de como hacer tu primer paquete usando debhelper.
.SH "COMANDOS DE DEBHELPER"
.IX Header "COMANDOS DE DEBHELPER"
A continuación la lista completa de los comandos de debhelper, para más
información consulta sus respectivas páginas del manual.
.Sp
.RS 4
.IP dh_builddeb(1)
construye paquetes debian
.IP dh_clean(1)
limpia los directorios creados durante la construcción del paquete
.IP dh_compress(1)
comprime ficheros y arregla los enlaces en los directorios de construcción del paquete
.IP dh_fixperms(1)
arregla los permisos de los ficheros en los directorios de construcción del paquete
.IP dh_gencontrol(1)
genera e instala el fichero de control
.IP dh_install(1)
instala archivos en los directorios de construcción del paquete
.IP dh_installchangelogs(1)
instala los changelogs en los directorios de construcción del paquete
.IP dh_installcron(1)
instala scripts de cron en etc/cron.*
.IP dh_installdeb(1)
instala archivos en el directorio DEBIAN
.IP dh_installdebconf(1)
instala archivos usados por debconf en los directorios de construcción del paquete
.IP dh_installdirs(1)
crea subdirectorios en los directorios de construcción del paquete
.IP dh_installdocs(1)
instala documentación en los directorios de construcción del paquete
.IP dh_installemacsen(1)
registra un paquete complementario de emacs
.IP dh_installexamples(1)
instala ficheros de ejemplo en los directorios de construcción del paquete
.IP dh_installinfo(1)
instala y registra los archivos info
.IP dh_installinit(1)
instala los scripts init en los directorios de construcción del paquete
.IP dh_installlogrotate(1)
instala los ficheros de configuración de logrotate
.IP dh_installman(1)
instala las paginas del manual en los directorios de construcción del paquete
.IP dh_installmanpages(1)
instalador de páginas man al viejo estilo
.IP dh_installmenu(1)
instala ficheros de menú de debian en los directorios de construcción del paquete
.IP dh_installmime(1)
instala los archivos mime en los directorios de construcción del paquete
.IP dh_installmodules(1)
registra los módulos con modutils
.IP dh_installpam(1)
instala los archivos de soporte para pam
.IP dh_installwm(1)
registra un gestor de ventanas
.IP dh_installxaw(1)
instala los ficheros de configuración de xaw wrappers en los
directorios de construcción del paquete
.IP dh_installxfonts(1)
registra las fuentes para X
.IP dh_link(1)
crea enlaces en los directorios de construcción del paquete
.IP dh_listpackages(1)
lista los paquetes binarios sobre los que debhelper actuará
.IP dh_makeshlibs(1)
crea automáticamente el fichero shlibs
.IP dh_md5sums(1)
genera el archivo DEBIAN/md5sums
.IP dh_movefiles(1)
mueve los archivos de debian/tmp ***a subpaquetes****
.IP dh_perl(1)
calcula scripts perl y dependencias de módulos
.IP dh_shlibdeps(1)
calcula dependencias de librerías compartidas
.IP dh_strip(1)
***strip*** ejecutables, librerías compartidas , y algunas librarías estáticas
.IP dh_suidregister(1)
obsoleto programa de registración suid
.IP dh_testdir(1)
comprueba el directorio antes de construir el paquete debian
.IP dh_testroot(1)
asegura que un paquete se construye como superusuario
.IP dh_testversion(1)
asegura que la versión correcta de debhelper está instalada
.IP dh_undocumented(1)
crea enlaces a la página de manual undocumented.7.gz

.RE
.SH "FICHEROS DE CONFIGURACIÓN DE DEBHELPER"
.IX Header "FICHEROS DE CONFIGURACIÓN DE DEBHELPER"
Muchos de los comandos de debhelper hacen uso de los ficheros en \fIdebian/\fR para 
controlar lo que hacen. Además de los  comunes \fIdebian/changelog\fR y
\fIdebian/control\fR, que están en todos los paquetes, no sólo
aquellos que usan debhelper, se pueden usar ficheros adicionales para
configurar el comportamiento de un comando específico de
debhelper. Estos ficheros se
suelen llamar debian/paquete.foo (donde \*(L"paquete\*(R", es
reemplazado por el paquete sobre el que se está trabajando).
.PP
Por ejemplo, dh_installdocs usa el archivo llamado debian/paquete.docs
para listar los ficheros de documentación que instalará. Lee las
páginas del manual de cada comando para más detalles acerca de los
nombres y formatos de los ficheros que usan.
.PP
Date cuenta que si un paquete es el primero (ó el único) paquete binario listado en
debian/control, debhelper usará debian/foo si no existe debian/paquete.foo.
.PP
En algunos caso raros, puedes querer tener diferentes versiones de los archivos
para diferentes arquitecturas. Si los ficheros debian/paquete.foo.arch existen,
donde \*(L"arch\*(R" es lo mismo que la salida de \*(L"dpkg \-\-print\-architecture\*(R",
entonces se usarán preferentemente a otros ficheros generales.
.PP
En muchos casos, estos ficheros de configuración se usan para especificar varios tipos de
ficheros. Documentación o ficheros de ejemplo a instalar, ficheros a mover, y demás.
Cuando sea apropiado, en casos como estos, puedes usar comodines del
shell como ('?' y '*')en estos ficheros.
.SH "OPCIONES COMPARTIDAS DE DEBHELPER"
.IX Header "OPCIONES COMPARTIDAS DE DEBHELPER"
La siguiente línea de comandos es aceptada por todos los programas de debhelper.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Modo explicativo: muestra todos los comandos que modifican el
directorio de construcción del paquete.
.IP "\fB\-\-no\-act\fR" 4
.IX Item "--no-act"
No hacer nada realmente. Si se usa con \-v, el resultado es que el comando mostrará todo lo que
hubiera hecho.
.IP "\fB\-a\fR, \fB\-\-arch\fR" 4
.IX Item "-a, --arch"
Actuar en todos los paquetes dependientes de la arquitectura.
.IP "\fB\-i\fR, \fB\-\-indep\fR" 4
.IX Item "-i, --indep"
Actuar en todos los paquetes independientes de la arquitectura.
.IP "\fB\-\fR\fIppaquete\fR, \fB\-\-package=\fR\fIpaquete\fR" 4
.IX Item "-ppaquete, --paquete=paquete"
Actúa en los paquetes nombrados \*(L"paquete\*(R". Esta opción puede ser especificada varias 
veces para hacer que debhelper opere sobre una serie de paquetes.
.IP "\fB\-s\fR, \fB\-\-same\-arch\fR" 4
.IX Item "-s, --same-arch"
Esta es una opción refinada de la opción \-a, que se usa en raras circunstancias.
Si el fichero de control tiene una línea para el paquete como \*(L"Architecture: i386\*(R"
, entonces debhelper no actuará sobre el paquete en otras arquitecturas. 
***Entonces esta opción hace que el comando actúe en todos los paquetes
\*(L"Architecture: any\*(R" ***así como en cualquier paquete que tenga la
arquitectura actual definida explícitamente. Esto es diferente al la
opción \-a, que hace que el comando actúe en todos los paquetes que son 
dependientes de la arquitectura.
.IP "\fB\-N\fR\fIpaquete\fR, \fB\-\-no\-package=\fR\fIpaquete\fR" 4
.IX Item "-Npaquete, --no-package=paquete"
No actuar sobre un paquete especificado incluso si las opciones \-a, \-i, o \-p listan
este paquete como uno sobre los que se debe actuar.
.IP "\fB\-P\fR\fItmpdir\fR, \fB\-\-tmpdir=\fR\fItmpdir\fR" 4
.IX Item "-Ptmpdir, --tmpdir=tmpdir"
Usa \*(L"tmpdir\*(R" como directorio para construir el paquete. Por defecto es debian/<paquete>.
.SH "OPCIONES COMUNES DE DEBHELPER"
.IX Header "OPCIONES COMUNES DE DEBHELPER"
Las siguientes opciones son válidas para algunos programas de debhelper.
Mira la página del manual de cada programa para una explicación
detallada de lo que hace cada uno.
.IP "\fB\-n\fR" 4
.IX Item "-n"
No modificar los scripts postinst/postrm/etc.
.IP "\fB\-X\fR\fIartículo\fR, \fB\-\-exclude=\fR\fIartículo\fR" 4
.IX Item "-X***artículo***, --exclude=***artículo***"
No procesar un ***Artículo***. Esta opción puede ser usada varias
veces, para excluir varias cosas.
.IP "\fB\-A\fR, \fB\-all\fR" 4
.IX Item "-A, -all"
Hace que los archivos o ***artículos*** especificados en la línea de comandos tengan efecto en
\s-1TODOS\s0 los paquetes sobre los que actúa, no sólo el primero.
.SH "NOTAS"
.IX Header "NOTAS"
.Sh "Soporte para varios paquetes binarios"
.IX Subsection "Soporte para varios paquetes binarios"
Si tu paquete fuente genera más de un paquete binario, por defecto los programas de debhelper
actuarán sobre todos los paquetes binarios. Si tu paquete fuente genera un paquete dependiente
de la arquitectura, y otro independiente, este no es el comportamiento correcto, porque tu 
necesitas generar los paquetes dependientes de la arquitectura en el 
***binary-arch debian/rules target***, y los paquetes independientes de la arquitectura
en el ***binary-indep debian/rules target***.
.PP
Para facilitar esto, así como para dar mayor control sobre que paquetes actúan los programas de
debhelper, todos estos aceptan los parámetros \&\fB\-a\fR, \fB\-i\fR, \fB\-p\fR, y \fB\-s\fR.
Estos parámetros son acumulativos.
Si no se especifica ninguno los programas de debhelper actúan por defecto en todos los paquetes
listados en el fichero de control.
.PP
Mira \fI/usr/share/doc/debhelper/examples/rules.multi\fR para ver un ejemplo de como usar esto
en un paquete que genera múltiples paquetes binarios.
.Sh "Generación automática de los scripts de instalación de debian"
.IX Subsection "Generación automática de los scripts de instalación de debian"
Algunos comandos de debhelper generarán automáticamente parte de los
scripts de instalación de Debian.
Si quieres que estos comandos generen automáticamente lo que esté incluido en tus scripts de
instalación de debian, entonces necesitas añadir \*(L"#DEBHELPER#\*(R" a tus scripts,
en el lugar donde el código deba de ser añadido. \*(L"#DEBHELPER#\*(R"
será remplazado por cualquier código auto-generado cuando ejecutes dh_installdeb.
.PP
Todos los scripts que generan código automáticamente de esta manera se pueden deshabilitar con
el parámetro \-n (ver arriba).
.PP
Fija té que el código insertado sera código de shell, por eso no puedes usarlo directamente es un
script perl. Si quieres introducirlo en un script perl, aquí tienes una forma de hacerlo 
(Date cuenta que yo me aseguré de que \f(CW$1\fR, \f(CW$2\fR, etc están establecidas con el
comando set):
.PP
.Vb 5
\&  my $temp="set -e\enset -- @ARGV\en" . << 'EOF';
\&  #DEBHELPER#
\&  EOF
\&  system ($temp) / 256 == 0
\&        or die "Problem with debhelper scripts: $!";
.Ve
.Sh "Generación automática de diversas dependencias."
.IX Subsection "Generación automática de diversas dependencias."
Algunos comandos de debhelper es posible que hagan que los paquetes
generado dependan de otros paquetes. Por ejemplo, si usas \fIdh_installdebconf\fR\|(1),
el paquete que generas dependerá de debconf. Si usas \&\fIdh_installxfonts\fR\|(1),
el paquete dependerá de una determinada versión de xutils. Llevar la cuenta de
todas estas dependencias puede ser tedioso, porque dependen de como debhelper
haga las cosas, por eso debhelper ofrece una manera de automatizarlo.

Todos los comandos de este tipo, además de documentar que dependencias
pueden ser necesarias en las páginas del manual, generarán automáticamente
****una variable substituible **** llamada ${misc:Depends}. Si pones
esta señal en el archivo debian/control, será expandida a las
dependencias que debhelper crea oportunas.
Esto es totalmente independiente de la estándar ${shlibs:Depends} generada por
\fIdh_makeshlibs\fR\|(1), y de la ${perl:Depends} generada por \fIdh_perl\fR\|(1).
Puedes elegir no elegir ninguna de estas si la expansión de debhelper
de estas variables no son correctas.
.Sh "Directorios de construcción del paquete"
.IX Subsection "Directorios de construcción del paquete"
Por defecto, todos los programas de debhelper asumen que el directorio
temporal usado para ensamblar el árbol de ficheros en un paquete es
debian/<paquete>.
.PP
Algunas veces, puede que desees usar otro directorio temporal. Esto
se puede conseguir con la opción \-P. Por ejemplo, \*(L"dh_installdocs
\-Pdebian/tmp\*(R", usará el directorio debian/tmp como directorio
temporal. Date cuenta que si usas la opción -P, los programas de
debhelper sólo pueden actuar sobre un paquete a la vez. Por eso, si
tienes un paquete que construye muchos paquetes binarios, tendrás que
hacer uso de la opción \-p para especificar el paquete binario sobre
el que debhelper actuará.
.Sh "Niveles de compatibilidad de debhelper"
.IX Subsection "Niveles de compatibilidad de debhelper"
Cada cierto tiempo, debhelper necesita cambios que lo pueden hacer
incompatible con versiones anteriores, para de este modo mantenerse
con un buen diseño a medida que necesita cambios y que su autor gana
más experiencia. Los niveles de compatibilidad de debhelper se crearon
para prevenir que estos cambios estropeen algún paquete. Según el
nivel de compatibilidad que se especifique debhelper se comporta de
diferentes maneras.
.PP
Para especificar un nivel de compatibilidad debes de escribir un
número en debian/compat. Por ejemplo, para activar el modo V4:
.PP
.Vb 1
\&  % echo 4 > debian/compat
.Ve
Los niveles de compatibilidad disponibles son:
.IP "V1" 4
.IX Item "V1"
Este es el nivel de compatibilidad original de debhelper, y por tanto
es el nivel por defecto. En este modo, debhelper usa debian/tmp como
el árbol de directorios y debian/paquete para el resto de paquetes
listados en el fichero de control. Se desaconseja su uso.
.IP "V2" 4
.IX Item "V2"
En este modo, debhelper usará consistentemente debian/<paquete>
como el árbol de directorios para cada paquete que se construya.
.IP "V3" 4
.IX Item "V3"
Este modo funciona como el V2 con los siguientes añadidos:
.RS 4
.IP "\-" 8
Los ficheros de configuración de Debhelper soportan ***comodines***
mediante * y ? cuando sea apropiado. Para usar * y ? simplemente como
caracteres poner como prefijo una barra invertida.
.IP "\-" 8
dh_makeshlibs hace que los scripts postinst y postrm ejecuten ldconfig.
.IP "\-" 8
dh_installdeb marca automáticamente todos los ficheros en etc/ como conffiles.
.RE
.RS 4
.RE
.IP "V4" 4
.IX Item "V4"
Este es el modo de operación aconsejado. Hace lo mismo que V3 y además:
.RS 4
.IP "\-" 8
dh_makeshlibs \-V no incluirá la parte de Debian en el numero de  versión
generado en la línea de dependencias del fichero shlibs.
.IP "\-" 8
dh_installinit usará el nuevo programa invoke\-rc.d en sus ***scripts de
mantenimiento generados***. ( Probablemente esto sea incluido
posteriormente en V3).
.IP "\-" 8
dh_fixperms hará ejecutables todos los archivos en los directorios bin/ y etc/init.d.
.IP "\-" 8
dh_link corregirá los enlaces existentes para ajustarse a la política
de debian.
.RE
.RS 4
.RE
.Sh "Enlaces a los directorios Doc"
.IX Subsection "Enlaces a los directorios Doc"
Aveces es útil hacer que un paquete no tenga un directorio
/usr/share/doc/paquete, en vez de esto se hará un enlace **colgante** en el paquete
binario que apunte a otro directorio doc. La política de Debian
permite esto mientras mientras el paquete dependa del paquete al que
pertenece el directorio doc que está usando. Para conseguir esto, lo
único que hay que hacer es no decirle a debhelper que cree ningún
directorio con documentación y usa dh_link para crear el enlace (o
crea el enlace a mano), y debhelper hará lo correcto. Date cuenta que es un
enlace **colgante** y no trates de instalar un fichero de copyright o changelog.
.Sh "Otras notas"
.IX Subsection "Otras notas"
En general si algún programa de debhelper necesita que exista un
directorio bajo debian/, lo creará. No me he preocupado por
documentarlo en todas las páginas del manual, pero por ejemplo,
dh_installdeb sabe hacer debian/<paquete>/DEBIAN/ antes de tratar de
poner los ficheros allí, dh_installmenu sabe que necesitas
debian/<paquete>/usr/lib/menu/ antes de instalar los archivos del
menú, etc.
.PP
Si estas generando un paquete que tiene partes independientes de la
arquitectura y partes dependientes, y estás usando dh_movefiles
para mover los archivos independientes de la arquitectura fuera del
directorio debian/tmp, tienes que asegurarte de que dh_movefiles lo
hace incluso si sólo el paquete dependiente de la arquitectura está
siendo construido (para portes a otras arquitecturas). Yo hago esto
en el fichero de las reglas de ejemplo \&\*(L"rules.multi\*(R"
ejecutando dh_movefiles sobre el objetivo de instalación.
.PP
Una vez que tu paquete usa debhelper para construirse, aseguraté de
añadir debhelper a tus dependencias de construcción en debian/control.
.SH "ENTORNO"
.IX Header "ENTORNO"
.IP "\s-1DH_VERBOSE\s0" 4
.IX Item "DH_VERBOSE"
Poner a uno para activar el modo explicativo. Debhelper mostrará
todos los comandos usados que modifiquen ficheros en el sistema
***construido / en construcción***.
.IP "\s-1DH_COMPAT\s0" 4
.IX Item "DH_COMPAT"
Especifica temporalmente bajo que nivel de compatibilidad debe de
actuar debhelper, ignorando cualquier valor en debian/compat.
.IP "\s-1DH_NO_ACT\s0" 4
.IX Item "DH_NO_ACT"
Poner a 1 para habilitar el modo no-act.
.IP "\s-1DH_OPTIONS\s0" 4
.IX Item "DH_OPTIONS"
Se tratará que todo lo que haya en esta variable se use como los argumentos en
la línea de comandos de todos los comandos de debhelper. Esto es útil
en algunas situaciones, por ejemplo, si necesitas pasar la opción \-p
a todos los comandos de debhelper que vas a utilizar. Si usas
\s-1DH_OPTIONS\s0, aseguraté de usar \*(Ldebhelper >= 1.1.17\*(R \*(--
debhelpers más antiguos la ignorarán y por lo tanto no harán lo
esperado. Una buena manera de dar valor a \s-1DH_OPTIONS\s0 es usando
\*(L"Target\-specific Variable Values\*(R" en tu fichero
debian/rules. Lee la documentación de make para los detalles sobre
como hacer esto.
.SH "VER ADEMÁS"
.IX Header "VER ADEMÁS"
.IP "\fI/usr/share/doc/debhelper/examples/\fR" 4
.IX Item "/usr/share/doc/debhelper/examples/"
Varios ficheros de ejemplo debian/rules que usan debhelper.
.IP "http://kitenet.net/programs/debhelper/"; 4
.IX Item "http://kitenet.net/programs/debhelper/";
Web de Debhelper.
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>
.SH "TRADUCTOR"
.IX Header "TRADUCTOR"
Rubén Porras <nahoo@inicia.es>

Reply to: