Provided by: debhelper_8.9.0ubuntu1_all bug

NOMBRE

       dh - Secuenciador de ordenes de debhelper

SINOPSIS

       dh secuencia [--with extensi'on[,extensi'on,...]] [--list] [--until
       orden] [--before orden] [--after orden] [--remaining] [opciones-de-
       debhelper]

DESCRIPCI'ON

       dh runs a sequence of debhelper commands. The supported sequences
       correspond to the targets of a debian/rules file: build-arch, build-
       indep, build, clean, install-indep, install-arch, install, binary-arch,
       binary-indep, and binary.

       Commands in the build-indep, install-indep and binary-indep sequences
       are passed the -i option to ensure they only work on architecture
       independent packages, and commands in the build-arch, install-arch and
       binary-arch sequences are passed the -a option to ensure they only work
       on architecture dependent packages.

       Si debian/rules contiene un objetivo con un nombre del tipo
       override_dh_orden, dh invocara este objetivo en lugar de ejecutar
       dh_orden. El objetivo <<override>> puede despues ejecutar la orden con
       opciones adicionales, o ejecutar otras ordenes totalmente diferentes.
       Consulte los ejemplos a continuacion. Tenga en cuenta que para usar
       esta funcionalidad, el paquete debe tener una dependencia de
       construccion sobre la version 7.0.50 o superior de debhelper.

OPCIONES

       --with extensi'on[,extensi'on,...]
           Anade las ordenes de debhelper definidas por la extension dada a
           los lugares apropiados de la secuencia de ordenes que se va a
           ejecutar. Esta opcion se puede repetir varias veces, o puede listar
           varias extensiones separadas por comas. Se usa cuando hay un
           paquete de terceras fuentes que proporciona ordenes de debhelper.
           Para mas documentacion sobre la interfaz de extension de secuencia
           consulte el fichero PROGRAMMING.

       --without extensi'on
           Lo contrario de --with, desactiva la extension dada.

       --list, -l
           Lista todas las extensiones disponibles.

       --until orden
           Ejecuta las ordenes en la secuencia hasta la orden, inclusive, y
           cierra.

       --before orden
           Ejecuta las ordenes en la secuencia anteriores a orden, y cierra.

       --after orden
           Ejecuta las ordenes en la secuencia posteriores a orden.

       --remaining
           Ejecuta todas las ordenes en la secuencia que aun no se han
           ejecutado.

       --no-act
           Muestra las ordenes que se ejecutarian para una secuencia dada,
           pero no las ejecuta.

       Todas las demas opciones introducidas a dh se introducen a cada orden
       que ejecuta. Puede usar esto para definir una opcion como -v, -X o -N,
       asi como opciones mas especializadas.

       En las opciones anteriores, orden puede ser el nombre completo de una
       orden de debhelper, o una subcadena. Buscara en primer lugar una orden
       en la secuencia que coincide totalmente con el nombre, para evitar
       cualquier ambiguedad. Si hay muchas coincidencias con la subcadena se
       usara la ultima en la secuencia.

EJEMPLOS

       Para ver que ordenes se incluyen en una secuencia, sin hacer nada en
       realidad:

               dh binary-arch --no-act

       Este es un fichero <<rules>> muy sencillo para paquetes donde las
       secuencias predeterminadas de ordenes funcionan sin opciones
       adicionales.

               #!/usr/bin/make -f
               %:
                       dh $@

       A menudo, querra introducir una opcion a una orden de debhelper en
       particular. La forma sencilla de hacerlo es anadir un objetivo
       <<overrride>> para esa orden.

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_strip:
                       dh_strip -Xfoo

               override_dh_installdocs:
                       dh_installdocs README TODO

       En ocasiones, las ordenes automatizadas dh_auto_configure(1) y
       dh_auto_build(1) no pueden averiguar que hacer con un paquete extrano.
       A continuacion puede ver como evitar que se ejecuten para que asi pueda
       ejecutar sus propias ordenes.

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_auto_configure:
                       ./mondoconfig

               override_dh_auto_build:
                       make universe-explode-in-delight

       Otra caso comun es que desee hacer algo manualmente antes o despues de
       que se ejecute una orden en particular de debhelper.

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_fixperms:
                       dh_fixperms
                       chmod 4755 debian/foo/usr/bin/foo

       Si su paquete es un paquete de Python, dh usara dh_pysupport de forma
       predeterminada. A continuacion puede ver como usar dh_pycentral en su
       lugar.

               #!/usr/bin/make -f
               %:
                       dh $@ --with python-central

       Si su paquete usa Autotools y desea refrescar config.sub y config.guess
       con nuevas versiones del paquete autotools-dev en tiempo de ejecucion,
       puede usar algunas ordenes proporcionadas por autotools-dev que
       automatizan esto, como puede ver a continuacion.

               #!/usr/bin/make -f
               %:
                       dh $@ --with autotools_dev

       A continuacion puede ver como forzar el uso del sistema de construccion
       del modulo Perl Module::Build, lo cual puede ser necesario si debhelper
       detecta erroneamente que el paquete usa MakeMaker.

               #!/usr/bin/make -f
               %:
                       dh $@ --buildsystem=perl_build

       Para parchear su paquete mediante quilt, puede indicar a dh que use las
       extensiones de secuencia de quilt para dh, como puede ver:

               #!/usr/bin/make -f
               %:
                       dh $@ --with quilt

       Aqui tiene un ejemplo de como sobreescribir la ubicacion donde las
       ordenes dh_auto_* encuentran el codigo fuente de un paquete, para un
       paquete en el que las fuentes se ubican en un subdirectorio.

               #!/usr/bin/make -f
               %:
                       dh $@ --sourcedirectory=src

       Y aqui tiene un ejemplo de como indicar a las ordenes dh_auto_* que
       realicen la construccion en un subdirectorio, que se eliminara mediante
       clean.

               #!/usr/bin/make -f
               %:
                       dh $@ --builddirectory=build

       Si su paquete se puede construir en paralelo, puede permitir la
       construccion en paralelo de la siguiente manera. Por ello, la orden
       dpkg-buildpackage -j funcionara.

               #!/usr/bin/make -f
               %:
                       dh $@ --parallel

       A continuacion puede ver como evitar que dh ejecute varias ordenes que
       no desea que se ejecuten. Para ello, defina objetivos <<override>>
       vacios para cada orden.

               #!/usr/bin/make -f
               %:
                       dh $@

               # Ordenes que no se ejecutan:
               override_dh_auto_test override_dh_compress override_dh_fixperms:

       A veces, puede que desee hacer que un objetivo <<override>> ejecute las
       ordenes solo cuando se construya un paquete en particular. Para ello,
       use dh_listpackages(1) para comprobar que paquete se esta construyendo.
       Por ejemplo:

               #!/usr/bin/make -f
               %:
                       dh $@

               override_dh_fixperms:
                       dh_fixperms
               ifneq (,$(filter foo, $(shell dh_listpackages)))
                       chmod 4755 debian/foo/usr/bin/foo
               endif

       Finally, remember that you are not limited to using override targets in
       the rules file when using dh. You can also explicitly define any of the
       regular rules file targets when it makes sense to do so. A common
       reason to do this is when your package needs different build-arch and
       build-indep targets.  For example, a package with a long document build
       process can put it in build-indep.

               #!/usr/bin/make -f
               %:
                       dh $@

               build-indep:
                       $(MAKE) docs
               build-arch:
                       $(MAKE) bins

       Note that in the example above, dh will arrange for "debian/rules
       build" to call your build-indep and build-arch targets. You do not need
       to explicitly define the dependencies in the rules file when using dh
       with compatability level v9. This example would be more complicated
       with earlier compatability levels.

FUNCIONAMIENTO INTERNO

       Si siente curiosidad por el funcionamiento interno de dh, a
       continuacion puede ver como funciona por dentro.

       Cada orden de debhelper registra una ejecucion exitosa en
       debian/package.debhelper.log. (que dh_clean elimina). Gracias a ello,
       dh puede conocer que ordenes se han ejecutado, para que paquetes, y
       omitir ejecutar esas ordenes otra vez.

       Cada vez que se ejecuta dh, comprueba el registro y encuentra la ultima
       orden registrada contenida en la secuencia especificada. Despues,
       continua con la siguiente orden en la secuencia. Las opciones --until,
       --before, --after y --remaining pueden anular este comportamiento.

       A sequence can also run dependent targets in debian/rules.  For
       example, the "binary" sequence runs the "install" target.

       dh sets environment variables listed by dpkg-buildflags, unless they
       are already set. It supports DEB_BUILD_OPTIONS=noopt too.

       dh usa la variable de entorno DH_INTERNAL_OPTIONS para introducir
       informacion a las ordenes de debhelper que se ejecutan dentro de
       objetivos <<override>>. El contenido (e incluso, la existencia) de esta
       variable de entorno, como el nombre sugiere, esta sujeto a cambios en
       cualquier momento.

V'EASE TAMBI'EN

       debhelper(7)

       Este programa es parte de debhelper.

AUTOR

       Joey Hess <joeyh@debian.org>

TRADUCTOR

       Traduccion de Omar Campagne Polaino
       <debian-l10n-spanish@lists.debian.org>