Provided by: debhelper_9.20160115ubuntu3_all 
NOMBRE
debhelper - El conjunto de herramientas debhelper
SINOPSIS
dh_* [-v] [-a] [-i] [-s] [--no-act] [-ppaquete] [-Npaquete] [-Pdirectorio-temporal]
DESCRIPCIÓN
debhelper ayuda a construir un paquete de Debian. La filosofía que se esconde detrás de debhelper es
ofrecer una colección de herramientas pequeñas, simples y fáciles de entender que se utilizan en
debian/rules para automatizar varios aspectos comunes a la hora de construir un paquete. Esto hace que
usted, el empaquetador, tenga menos trabajo. Además, si cambian las directrices de Debian, los paquetes
que precisan cambios sólo necesitan ser reconstruidos para que se ajusten a las nuevas directrices.
Un fichero debian/rules típico que utiliza debhelper invoca órdenes de debhelper en cadena, o utiliza
dh(1) para automatizar el proceso. Puede encontrar ejemplos de ficheros «rules» que usan debhelper en
/usr/share/doc/debhelper/examples/.
Para crear un nuevo paquete de Debian utilizando debhelper, simplemente puede copiar uno de los ficheros
«rules» de ejemplo y editarlo a mano, o utilizar el paquete dh-make, que contiene la orden dh_make, que
automatiza parcialmente el proceso. Para una introducción más apropiada, el paquete maint-guide contiene
una guía que muestra cómo hacer su primer paquete que utiliza debhelper (N. del T. existe una versión
traducida al castellano en el paquete maint-guide-es).
ÓRDENES DE DEBHELPER
A continuación se muestra una lista de las órdenes de debhelper que puede usar. Para más información
consulte sus respectivas páginas de manual.
dh_auto_build(1)
Construye un paquete de forma automática
dh_auto_clean(1)
Limpia automáticamente después de una construcción
dh_auto_configure(1)
Configura un paquete automáticamente antes de la construcción
dh_auto_install(1)
Ejecuta «make install» o similar automáticamente
dh_auto_test(1)
Ejecuta automáticamente un conjunto de pruebas de un paquete
dh_bugfiles(1)
Instala ficheros personalizados para el informe de fallos en los directorios de construcción del
paquete
dh_builddeb(1)
Construye paquetes binarios de Debian
dh_compress(1)
Comprime ficheros y arregla enlaces simbólicos en los directorios de construcción del paquete
dh_fixperms(1)
Arregla los permisos de los ficheros en los directorios de construcción
dh_gconf(1)
Instala ficheros de valores predeterminados de GConf y registra esquemas
dh_gencontrol(1)
Genera e instala el fichero de control
dh_icons(1)
Update caches of Freedesktop icons
dh_installcatalogs(1)
Instala y registra catálogos SGML
dh_installchangelogs(1)
Instala los ficheros de cambios en los directorios de construcción
dh_installcron(1)
Instala scripts para cron en etc/cron.*
dh_installdeb(1)
Instala ficheros en el directorio DEBIAN
dh_installdebconf(1)
Instala ficheros utilizados por debconf en los directorios de construcción
dh_installdirs(1)
Crea subdirectorios en los directorios de construcción del paquete
dh_installdocs(1)
Instala documentación en los directorios de construcción del paquete
dh_installemacsen(1)
Registra un paquete de extensión de Emacs
dh_installexamples(1)
Instala ficheros de ejemplo en los directorios de construcción
dh_installifupdown(1)
Instala «hooks» para if-up e if-down
dh_installinfo(1)
Instala ficheros info
dh_installinit(1)
install service init files into package build directories
dh_installlogcheck(1)
Instala ficheros de reglas para logcheck en etc/logcheck/
dh_installlogrotate(1)
Instala ficheros de configuración de logrotate
dh_installman(1)
Instala páginas de manual en los directorios de construcción del paquete
dh_installmenu(1)
Instala ficheros de menú de Debian en los directorios de construcción del paquete
dh_installmime(1)
Instala ficheros mime en los directorios de construcción del paquete
dh_installmodules(1)
register kernel modules
dh_installpam(1)
Instala ficheros de compatibilidad de pam
dh_installppp(1)
Instala los ficheros ip-up e ip-down de ppp
dh_installinfo(1)
Instala ficheros de reglas de udev
dh_installwm(1)
Registra un gestor de ventanas
dh_installxfonts(1)
Registra tipos de letra para X
dh_link(1)
Crea enlace simbólicos en los directorios de construcción del paquete
dh_lintian(1)
Instala ficheros «override» de lintian en los directorios de construcción del paquete
dh_listpackages(1)
Lista los paquetes binarios sobre los que actuará debhelper
dh_makeshlibs(1)
Crea automáticamente el fichero «shlibs» e invoca dpkg-gensymbols
dh_md5sums(1)
Genera el fichero DEBIAN/md5sums
dh_movefiles(1)
Mueve ficheros desde debian/tmp a subpaquetes
dh_perl(1)
Calcula dependencias de Perl y limpia después de MakeMaker
dh_prep(1)
Realiza una limpieza para preparar la construcción de un paquete binario
dh_shlibdeps(1)
Calcula dependencias sobre bibliotecas compartidas
dh_testdir(1)
Comprueba el directorio antes de construir un paquete de Debian
dh_testroot(1)
Compruebe que el paquete se construye como usuario «root»
dh_usrlocal(1)
Migra directorios «usr/local» a scripts del desarrollador
Órdenes obsoletas
Existe un conjunto de órdenes de debhelper que han quedado obsoletas y que no se deberían utilizar.
dh_desktop(1)
Orden obsoleta sin efecto
dh_installmanpages(1)
Instalador de viejo estilo de páginas de manual (obsoleto)
dh_scrollkeeper(1)
Orden obsoleta sin efecto
dh_suidregister(1)
Programa de registro suid (obsoleto)
dh_undocumented(1)
Programa de enlace simbólico a undocumented.7 (orden obsoleta sin efecto)
Otras órdenes
Si el nombre de un programa empieza con dh_, y no está en las listas anteriores, no es parte del paquete
debhelper, pero aún así debería funcionar como los programas descritos en está página.
FICHEROS DE CONFIGURACIÓN DE DEBHELPER
Muchas de las órdenes de debhelper hacen uso de ficheros en debian/ para controlar lo que hacen. Además
de los ficheros comunes debian/changelog y debian/control, que están en todos los paquetes, no sólo
aquellos que utilizan debhelper, se pueden utilizar ficheros adicionales para configurar el
comportamiento de una orden específica de debhelper. Estos ficheros se suelen llamar «debian/paquete.tal»
(donde paquete es reemplazado por el paquete sobre el que se está actuando).
Por ejemplo, dh_installdocs utiliza ficheros llamados debian/paquete.docs para listar los ficheros de
documentación que instalará. Consulte las páginas de manual de cada orden para conocer más detalles
acerca de los nombres y formatos de los ficheros que utilizan. Habitualmente, estos ficheros listan los
ficheros sobre los que se actúa, uno por línea. Algunos programas de debhelper utilizan parejas de
ficheros y destinos o algún formato un poco más complicado.
Tenga en cuenta que si un paquete es el primero (o el único) paquete binario listado en debian/control,
debhelper utiliza debian/tal si no existe un fichero debian/paquete.tal.
En algunos casos especiales, puede querer tener diferentes versiones de estos ficheros para diferentes
arquitecturas o sistemas operativos. Si los ficheros «debian/paquete.tal.ARCH» y «debian/paquete.tal.OS»
existen, donde ARCH y OS son igual a las salidas de «dpkg-architecture -qDEB_HOST_ARCH» / «dpkg-
architecture -qDEB_HOST_ARCH_OS», se utilizarán preferentemente a otros ficheros generales.
Generalmente, estos ficheros de configuración se utilizan para definir 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, puede utilizar comodines del intérprete de órdenes como (?, * y clases de carácter [..]) en
estos ficheros. También puede incluir comentarios en estos ficheros; se ignoran las líneas que empiezan
con #.
La sintaxis de estos ficheros es intencionadamente sencilla para facilitar la lectura, la comprensión y
la modificación. Si prefiere potencia y complejidad, puede dar al fichero permisos de ejecución, y crear
un programa que muestra un contenido adecuado para la situación dada. Si lo hace, la salida no se proceso
para expandir comodines o eliminar comentarios.
OPCIONES COMPARTIDAS DE DEBHELPER
Las siguientes opciones de línea de órdenes son aceptadas por todos los programas de debhelper.
-v, --verbose
Modo explicativo: muestra todas las órdenes que modifican el directorio de construcción del paquete.
--no-act
No hace nada realmente. Si se utiliza con «-v», mostrará todo lo que hubiera hecho.
-a, --arch
Actúa sobre todos los paquetes dependientes de la arquitectura que se deberían construir para la
arquitectura de construcción.
-i, --indep
Actúa en todos los paquetes independientes de la arquitectura.
-ppaquete, --package=paquete
Actúa sobre el paquete nombrado paquete. Esta opción se puede definir varias veces para hacer que
debhelper opere sobre un conjunto dado de paquetes.
-s, --same-arch
Solía ser una versión más inteligente de la opción -a, pero actualmente la opción -a es igual de
inteligente.
-Npaquete, --no-package=paquete
No actúa sobre un paquete especificado incluso si las opciones -a, -i, o -p listan este paquete como
uno sobre los que se debería actuar.
--remaining-packages
No actúa sobre los paquetes sobre los que ya se actuó anteriormente con esta orden de debhelper (esto
es, si la orden está presente en el registro de debhelper). Por ejemplo, si necesita invocar la orden
con opciones particulares para una pareja de paquetes binarios, introduzca esta opción a la última
invocación de la orden para procesar el resto de paquetes con la configuración predeterminada.
--ignore=fichero
Ignora el fichero dado. Se puede utilizar si debian/ contiene un fichero de configuración de
debhelper sobre el que una orden de debhelper no debería actuar. Tenga en cuenta que no puede ignorar
debian/compat, debian/control y debian/changelog, aunque nunca debería existir una razón para ignorar
esos ficheros.
Por ejemplo, si la fuente original distribuye un fichero debian/init que no desea que dh_installinit
instale, use --ignore=debian/init.
-Pdirectorio_temporal, --tmpdir=directorio_temporal
Utiliza directorio_temporal como el directorio de construcción del paquete. Por omisión es
«debian/paquete».
--mainpackage=paquete
Esta opción poco utilizada cambia el paquete que debhelper considera el «paquete principal», esto es,
el primero listado en debian/control, y sobre el cual se pueden utilizar los ficheros debian/tal en
vez de los usuales debian/package.tal.
-O=opción|fichero
dh(1) utiliza está orden al orden al introducir opciones definidas por el usuario a todas las órdenes
que ejecuta. Si la orden acepta la opción definida o conjunto de opciones, tendrá efecto. Si la orden
no acepta la opción (o alguna sección del conjunto de opciones), se ignorará.
OPCIONES COMUNES DE DEBHELPER
Las siguientes opciones son válidas para algunos programas de debhelper. Consulte la página de manual de
cada programa para una explicación detallada de lo que hace cada una.
-n No modifica los scripts postinst, postrm, etc.
-Xelemento, --exclude=elemento
Exclude an item from processing. This option may be used multiple times, to exclude more than one
thing. The \fIitem\fR is typically part of a filename, and any file containing the specified text
will be excluded.
-A, --all
Hace que los ficheros o elementos especificados en la línea de órdenes tengan efecto en TODOS los
paquetes sobre los que actúa, no sólo el primero.
OPCIONES DEL SISTEMA DE CONSTRUCCIÓN
Las siguientes opciones de línea de órdenes son compatibles con todos los programas dh_auto_* de
debhelper. Estos programas permiten utilizar varios sistemas de construcción, y habitualmente realizan
una estimación de cuál utilizar, y cómo. Puede utilizar estas opciones de línea de órdenes para anular el
comportamiento predeterminado. Habitualmente, se introducen a dh(1), que a su vez los introduce en todos
los programas dh_auto_*.
-Ssistema-de-construcción, --buildsystem=sistema-de-construcción
Fuerza el uso del sistema-de-construcción definido, en lugar de intentar seleccionar uno de forma
automática que podría ser adecuado para el paquete.
-Ddirectorio, --sourcedirectory=directorio
Supone que el árbol de código fuente original del paquete está en el directorio definido, en lugar
del directorio de nivel superior del árbol del paquete fuente de Debian.
-B[directorio], --builddirectory=[directorio]
Enable out of source building and use the specified directory as the build directory. If directory
parameter is omitted, a default build directory will be chosen.
Si no se define esta opción, la construcción tendrá lugar en las fuentes de forma predeterminada a
menos que el sistema de construcción requiera o prefiera la construcción fuera del árbol de fuentes.
En ese caso, se utilizará el directorio de construcción predeterminado incluso si no se define
--builddirectory.
Si el sistema de construcción prefiere realizar la construcción fuera del árbol de fuentes, pero
permite la construcción en las fuentes, puede reactivar lo último introduciendo una ruta al
directorio de construcción igual a la ruta del directorio de fuentes.
--parallel, --no-parallel
Control whether parallel builds should be used if underlying build system supports them. The number
of parallel jobs is controlled by the DEB_BUILD_OPTIONS environment variable ("Debian Policy, section
4.9.1") at build time. It might also be subject to a build system specific limit.
If neither option is specified, debhelper currently defaults to --parallel in compat 10 (or later)
and --no-parallel otherwise.
As an optimization, dh will try to avoid passing these options to subprocesses, if they are
unncessary and the only options passed. Notably this happens when DEB_BUILD_OPTIONS does not have a
parallel parameter (or its value is 1).
--max-parallel=máximo
Esta opción implica --parallel, y permite limitar el número de tareas que se pueden utilizar en una
construcción en paralelo. Si se sabe que la construcción del paquete sólo funciona con ciertos
niveles de concurrencia, puede definir esto con el nivel máximo conocido con el que funciona, o que
desea permitir.
Notably, setting the maximum to 1 is effectively the same as using --no-parallel.
--list, -l
Lista todos los sistemas construcción en el sistema que debhelper acepta. La lista incluye sistemas
de construcción de terceras fuentes (marcadas como tal) y la predeterminada. También muestra el
sistema de construcción que se seleccionará automáticamente, o cuál está definido mediante la opción
--buildsystem.
NIVELES DE COMPATIBILIDAD
Cada cierto tiempo, debhelper necesita cambios que lo pueden hacer incompatible con versiones anteriores
para así continuar con un buen y limpio diseño a medida que las necesidades cambian y que su autor gana
más experiencia. Los niveles de compatibilidad de debhelper se crearon para impedir que estos cambios
estropeen algún paquete. Según el nivel de compatibilidad que se especifique debhelper se comporta de
diferentes maneras.
Para especificar a debhelper qué nivel de compatibilidad debe utilizar, escriba un número en
debian/compat. Por ejemplo, para activar el modo v9:
% echo 9 > debian/compat
El paquete también requiere como dependencia de construcción («build-depend») una versión de debhelper
igual o mayor que el nivel de compatibilidad de debhelper que utiliza el paquete. Por ejemplo, para
utilizar el nivel de compatibilidad 9, compruebe que «debian/control» contiene lo siguiente:
Build-Depends: debhelper (>= 9)
A menos que se indique lo contrario, toda la documentación de debhelper supone que utiliza el nivel de
compatibilidad más reciente, y en la mayoría de los casos no indica si el comportamiento de debhelper es
distinto bajo otro nivel de compatibilidad. Por ello, si no está utilizando el nivel de compatibilidad
más reciente, recomendamos que lea a continuación las notas acerca de las diferencias con anteriores
niveles de compatibilidad.
Los niveles de compatibilidad disponibles son:
v3 This is the lowest supported compatibility level.
Este modo está obsoleto.
v4 Los cambios desde el nivel v3 son:
- 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».
- Se aconseja que use el nuevo ${misc:Depends} en debian/control para reemplazar el campo
${shlibs:Depends}.
- dh_fixperms hará ejecutables todos los ficheros en los directorios bin/ y etc/init.d.
- dh_link corregirá los enlaces existentes para ajustarse a las normas de Debian.
Este modo está obsoleto.
v5 Los cambios desde el nivel v4 son:
- Se ignoran los comentarios en los ficheros de configuración de debhelper.
- dh_strip --dbg-package ahora especifica el nombre del paquete en el que se colocan los
símbolos de depuración, no los paquetes desde los que obtener los símbolos.
- dh_installdocs omite la instalación de ficheros vacíos.
- dh_install devuelve un error si los comodines se expanden a un valor vacío.
v6 Los cambios desde el nivel v5 son:
- Las órdenes que generan segmentos de scripts de desarrollador ordenarán estos segmentos en
orden inverso para los scripts prerm y postrm.
- dh_installwm instalará un enlace esclavo a la página de manual x-window-manager.1.gz en caso
de encontrar la página de manual en usr/share/man/man1 dentro del directorio de construcción
del paquete.
- Anteriormente, dh_builddeb no eliminaba todo aquello que coincidiese con DH_ALWAYS_EXCLUDE,
si es que se definía con una lista de elementos a excluir, como por ejemplo CVS:.svn:.git.
Ahora sí lo hace.
- dh_installman permite sobreescribir páginas de manual existentes en el directorio de
construcción del paquete. Bajo los niveles de compatibilidad anteriores simplemente rechazaba
hacerlo, de forma silenciosa.
v7 Los cambios desde el nivel v6 son:
- dh_install buscará ficheros en debian/tmp de forma predeterminada si no los encuentra en el
directorio actual (o dónde indicó hacerlo mediante --sourcedir). Esto permite la
interoperabilidad entre dh_install y dh_auto_install, que instala en debian/tmp, sin
necesidad de parámetros especiales.
- dh_clean leerá debian/clean y eliminará los ficheros ahí listados.
- dh_clean eliminará ficheros *-stamp del nivel superior.
- dh_installchangelogs intentará averiguar el fichero de registro de cambios de la fuente
original si no se especifica ninguno.
v8 Los cambios desde el nivel v7 son:
- Las órdenes fallarán, en lugar de emitir un aviso, cuando se les introduzcan opciones
desconocidas.
- dh_makeshlibs ejecutará dpkg-gensymbols sobre todas las bibliotecas compartidas para las que
genera ficheros «shlibs». Por ello, puede utilizar -X para excluir bibliotecas. Así mismo, se
introducirán a dpkg-gensymbols bibliotecas en ubicaciones inusuales que antes no procesaba,
un cambio de comportamiento que puede impedir la construcción de algunos paquetes.
- dh requiere que la secuencia a ejecutar se defina como el primer parámetro, y que las
opciones aparezcan a continuación. Por ejemplo, use dh $@ --foo, no dh --foo $@.
- dh_auto_* prefiere utilizar el módulo de Perl Module::Build con preferencia a un fichero
Makefile.PL.
v9 Este es el modo de operación aconsejado.
Los cambios desde el nivel v8 son:
- Compatibilidad multiarquitectura, dh_auto_configure introduce directorios multiarquitectura a
autoconf en «--libdir» y «--libexecdir».
- dh es consciente de las dependencias habituales entre objetivos en «debian/rules». Por ello,
«dh binary» ejecuta cualquier objetivo build, build-arch, build-indep e install que se
encuentre en el fichero «rules». No es necesario definir un objetivo binario explícito con
dependencias explícitas sobre otros objetivos.
- dh_strip comprime ficheros de símbolos de depuración de fallos para reducir el tamaño de los
paquetes -dbg.
- dh_auto_configure no incluye el nombre de paquete fuente en «--libexecdir» al utilizar
autoconf.
- dh no activa «--with=python-support» de forma predeterminada.
- Todos los programas de debhelper dh_auto_* definen variables de entorno listados en dpkg-
buildflags, a menos que ya estén definidas.
- dh_auto_configure introduce dpkg-buildflags CFLAGS, CPPFLAGS, y LDFLAGS a ficheros de Perl
Makefile.PL y Build.PL
- dh_strip ubica símbolos de depuración separados en una ubicación según su build-id.
- Se utilizan como configuración los ficheros de configuración ejecutables de debhelper y su
salida.
v10 Este nivel de compatibilidad aún está en desarrollo, utilícelo con precaución.
Los cambios desde el nivel v9 son:
- dh_installinit will no longer install a file named debian/package as an init script.
- dh_installdocs will error out if it detects links created with --link-doc between packages of
architecture "all" and non-"all" as it breaks binNMUs.
- dh no longer creates the package build directory when skipping running debhelper commands.
This will not affect packages that only build with debhelper commands, but it may expose bugs
in commands not included in debhelper.
- dh_installdeb no longer installs a maintainer-provided debian/package.shlibs file. This is
now done by dh_makeshlibs instead.
- dh_installwm refuses to create a broken package if no man page can be found (required to
register for the x-window-manager alternative).
- Debhelper will default to --parallel for all buildsystems that support parallel building.
This can be disabled by using either --no-parallel or passing --max-parallel with a value of
1.
- The dh command will not accept any of the deprecated "manual sequence control" parameters
(--before, --after, etc.). Please migrate to use override targets instead.
- The dh command will no longer use log files to track which commands have been run. The dh
command still keeps track of whether it already ran the "build" sequence and skip it if it
did.
The main affects of this are:
- With this, it is now easier to debug the install or/and binary sequences because they can
now trivially be re-run (without having to do a full "clean and rebuild" cycle)
- The main caveat is that dh_* now only keeps track of what happened in a single override
target. When all the calls to a given dh_cmd command happens in the same override target
every thing will work as before.
Example of where it can go wrong:
override_dh_foo:
dh_foo -pmy-pkg
override_dh_bar:
dh_bar
dh_foo --remaining
In this case, the call to dh_foo --remaining will also include my-pkg, since dh_foo
-pmy-pkg was run in a separate override target. This issue is not limited to
--remaining, but also includes -a, -i, etc.
NOTAS
Compatibilidad con varios paquetes binarios
Si su paquete fuente genera más de un paquete binario, los programas de debhelper actuarán sobre todos
los paquetes binarios de forma predeterminada. Si se diera el caso de que su paquete fuente genera un
paquete dependiente de la arquitectura, y otro independiente, éste no sería un comportamiento correcto
porque necesitará generar los paquetes dependientes de la arquitectura en el objetivo binary-arch de
debian/rules, y los paquetes independientes de la arquitectura en el objetivo binary-indep de
debian/rules.
To facilitate this, as well as give you more control over which packages are acted on by debhelper
programs, all debhelper programs accept the -a, -i, -p, and -s parameters. These parameters are
cumulative. If none are given, debhelper programs default to acting on all packages listed in the
control file, with the exceptions below.
First, any package whose Architecture field in debian/control does not match the build architecture will
be excluded ("Debian Policy, section 5.6.8").
Also, some additional packages may be excluded based on the contents of the DEB_BUILD_PROFILES
environment variable and Build-Profiles fields in binary package stanzas in debian/control, according to
the draft policy at <https://wiki.debian.org/BuildProfileSpec>.
Generación automática de los scripts de instalación de Debian
Algunas órdenes de debhelper generarán automáticamente parte de los scripts de instalación de Debian. Si
quiere que estas órdenes generen automáticamente lo que esté incluido en sus scripts de instalación de
Debian, necesitará añadir #DEBHELPER# a sus scripts, en el lugar donde el código se deba añadir.
#DEBHELPER# será remplazado por cualquier código auto-generado cuando ejecute dh_installdeb.
Si el script no existe y debhelper necesita añadir algo en particular, creará el script por completo.
Todas las órdenes de debhelper que generan código automáticamente de esta manera se pueden deshabilitar
con el parámetro «-n» (ver arriba).
Observe que el código insertado sera código de consola, y por ello no puede utilizarlo directamente en un
script de Perl. Si desea introducirlo en un script de Perl, hágalo de la siguiente forma (tenga en cuenta
que en este caso comprobé que $1, $2, etc se definen con la orden «set»):
my $temp="set -e\nset -- @ARGV\n" . << 'EOF';
#DEBHELPER#
EOF
if (system($temp)) {
my $exit_code = ($? >> 8) & 0xff;
my $signal = $? & 0x7f;
if ($exit_code) {
die("The debhelper script failed with error code: ${exit_code}");
} else {
die("The debhelper script was killed by signal: ${signal}");
}
}
Generación automática de diversas dependencias.
Es posible que algunas órdenes de debhelper hagan que los paquetes generados dependan de otros paquetes.
Por ejemplo, si utiliza dh_installdebconf(1), el paquete generado dependerá de debconf. Si utiliza
dh_installxfonts(1), el paquete dependerá de una determinada versión de xutils. Llevar la cuenta de todas
estas dependencias puede ser tedioso porque dependen de cómo debhelper haga las cosas, y por ello
debhelper ofrece una manera de automatizarlo.
Todas las órdenes de este tipo, además de documentar qué dependencias pueden ser necesarias en sus
páginas de manual, generarán automáticamente una variable de sustitución llamada ${misc:Depends}. Si
introduce esta variable en el fichero debian/control, se expandirá a las dependencias que debhelper crea
oportunas.
Esto es totalmente independiente del campo estándar ${shlibs:Depends} generado por dh_makeshlibs(1), y
del ${perl:Depends} generada por dh_perl(1). Puede preferir no utilizar ninguno de estos si la expansión
de debhelper de estas variables no es correcta.
Directorios de construcción del paquete
Por omisión, todos los programas de debhelper asumen que el directorio temporal utilizado para ensamblar
el árbol de ficheros en un paquete es «debian/paquete».
Algunas veces, puede que desee utilizar otro directorio temporal. Esto se puede conseguir con la opción
-P. Por ejemplo, dh_installdocs -Pdebian/tmp, utilizará el directorio debian/tmp como directorio
temporal. Tenga en cuenta que si utiliza la opción -P, los programas de debhelper sólo podrán actuar
sobre un paquete a la vez. Por eso, si tiene un paquete que construye muchos paquetes binarios, tendrá
que hacer uso de la opción -p para especificar el paquete binario sobre el que debhelper actuará.
udebs
Debhelper incluye la compatibilidad con paquetes udeb. Para crear un udeb con debhelper, añada Package-
Type: udeb al párrafo del paquete binario en debian/control. Debhelper tratará de crear udebs que cumplan
con las normas de debian-installer, haciendo que los ficheros de los paquetes terminen en .udeb, no
instalando ninguna documentación en un udeb, y omitiendo los scripts preinst, postrm, prerm, scripts
config, etc.
ENTORNO
The following environment variables can influence the behavior of debhelper. It is important to note
that these must be actual environment variables in order to function properly (not simply Makefile
variables). To specify them properly in debian/rules, be sure to "export" them. For example, "export
DH_VERBOSE".
DH_VERBOSE
Set to 1 to enable verbose mode. Debhelper will output every command it runs. Also enables verbose
build logs for some build systems like autoconf.
DH_QUIET
Set to 1 to enable quiet mode. Debhelper will not output commands calling the upstream build system
nor will dh print which subcommands are called and depending on the upstream build system might make
that more quiet, too. This makes it easier to spot important messages but makes the output quite
useless as buildd log. Ignored if DH_VERBOSE is also set.
DH_COMPAT
Especifica temporalmente bajo qué nivel de compatibilidad debe actuar debhelper, ignorando cualquier
valor en debian/compat.
DH_NO_ACT
Defina como 1 para habilitar el modo no-act.
DH_OPTIONS
Cualquier dato contenido en esta variable se añade a los argumentos de línea de órdenes de todas las
órdenes de debhelper.
Al utilizar dh(1), puede aceptar opciones que se introducen a cada orden de debhelper, lo que
habitualmente es mejor que utilizar «DH_OPTIONS».
DH_ALWAYS_EXCLUDE
Si se define, añade su valor a la opción -X de todas las órdenes que permiten dicha opción. Es más,
dh_builddeb ejecutará rm -rf con todo lo que coincida con el valor dentro del árbol de construcción
del paquete.
Puede ser útil si está compilando desde un árbol de CVS, en cuyo caso estableciendo
DH_ALWAYS_EXCLUDE=CVS evitará que los directorios CVS se introduzcan en el paquete construido. O, si
su paquete original (imprudentemente) incluye directorios CVS, puede ser útil exportar
DH_ALWAYS_EXCLUDE=CVS en debian/rules, para que esto tenga efecto en cualquier sitio donde se
construya el paquete.
Puede separar varias cosas a excluir mediante dos puntos, por ejemplo: DH_ALWAYS_EXCLUDE=CVS:.svn
VÉASE TAMBIÉN
/usr/share/doc/debhelper/examples/
Varios ficheros de ejemplo debian/rules que utilizan debhelper.
<http://joeyh.name/code/debhelper/>
Sitio web de Debhelper.
AUTOR
Joey Hess <joeyh@debian.org>
TRADUCTOR
Traducci�n de Rub�n Porras Campo <debian-l10n-spanish@lists.debian.org> Actualizaci�n de Omar Campagne
Polaino
9.20160115ubuntu3 2016-03-31 debhelper(7)