.\" Automatically generated by Pod::Man 4.10 (Pod::Simple 3.35)
.\"
.\" Standard preamble:
.\" ========================================================================
.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.  \*(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-
.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" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "DH 1"
.TH DH 1 "2019-09-14" "12.6" "Debhelper"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOMBRE"
.IX Header "NOMBRE"
dh \- Secuenciador de órdenes de debhelper
.SH "SINOPSIS"
.IX Header "SINOPSIS"
\&\fBdh\fR \fIsequence\fR [\fB\-\-with\fR \fIaddon\fR[\fB,\fR\fIaddon\fR ...]] [\fB\-\-list\fR]
[\fIopciones-de-debhelper\fR]
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
\&\fBdh\fR ejecuta una secuencia de órdenes de debhelper. Las \fIsecuencias\fR
aceptadas se corresponden con los objetivos de un fichero \fIdebian/rules\fR:
\&\fBbuild-arch\fR, \fBbuild-indep\fR, \fBbuild\fR, \fBclean\fR, \fBinstall-indep\fR,
\&\fBinstall-arch\fR, \fBinstall\fR, \fBbinary-arch\fR, \fBbinary-indep\fR, y \fBbinary\fR.
.SH "OBJETIVOS «OVERRIDE»"
.IX Header "OBJETIVOS «OVERRIDE»"
Un fichero \fIdebian/rules\fR que utiliza \fBdh\fR puede sustituir la orden que se
ejecuta en cualquier punto de una secuencia, definiendo un objetivo
«override».
.PP
To override \fIdh_command\fR, add a target named \fBoverride_\fR\fIdh_command\fR to
the rules file. When it would normally run \fIdh_command\fR, \fBdh\fR will instead
call that target. The override target can then run the command with
additional options, or run entirely different commands instead. See examples
below.
.PP
Los objetivos «override» también se pueden definir para que se ejecuten solo
al consuitr paquetes dependientes o independientes de la
arquitectura. Utilice objetivos con nombres como
\&\fBoverride_\fR\fIdh_orden\fR\fB\-arch\fR y \fBoverride_\fR\fIdh_orden\fR\fB\-indep\fR. Tenga en
cuenta que para utilizar esta funcionalidad, el paquete debe tener una
dependencia de construcción sobre la versión 7.0.50 o superior de debhelper.
.SH "OPCIONES"
.IX Header "OPCIONES"
.IP "\fB\-\-with\fR \fIextensión\fR[\fB,\fR\fIextensión\fR,...]" 4
.IX Item "--with extensión[,extensión,...]"
Añade las órdenes de debhelper definidas por la extensión dada a los lugares
apropiados de la secuencia de órdenes que se va a ejecutar. Esta opción se
puede repetir varias veces, o puede listar varias extensiones separadas por
comas. Se utiliza cuando hay un paquete de terceras fuentes que proporciona
órdenes de debhelper. Para más documentación sobre la interfaz de extensión
de secuencia consulte el fichero \fI\s-1PROGRAMMING\s0\fR.
.Sp
A \fBBuild-Depends\fR relation on the package \fBdh\-sequence\-\fR\fIaddon\fR implies a
\&\fB\-\-with\fR \fIaddon\fR. This avoids the need for an explicit \fB\-\-with\fR in
\&\fIdebian/rules\fR that only duplicates what is already declared via the build
dependencies in \fIdebian/control\fR.  The relation can (since 12.5) be made
optional via e.g.  build-profiles.  This enables you to easily disable an
addon that is only useful with certain profiles (e.g. to facilitate
bootstraping).
.Sp
Since debhelper 12.5, addons can also be activated in \fBindep\fR\-only mode
(via \fBBuild-Depends-Indep\fR) or \fBarch\fR\-only mode (via
\&\fBBuild-Depends-Arch\fR). Such addons are only active in the particular
sequence (e.g. \fBbinary-indep\fR) which simplifies dependency management for
cross-builds.
.Sp
Please note that addons activated via \fBBuild-Depends-Indep\fR or
\&\fBBuild-Depends-Arch\fR are subject to additional limitations to ensure the
result is deterministic even when the addon is unavailable (e.g. during
clean).  This implies that some addons are incompatible with these
restrictions and can only be used via \fBBuild-Depends\fR (or manually via
\&\fIdebian/rules\fR).  Currently, such addons can only add commands to
sequences.
.IP "\fB\-\-without\fR \fIextensión\fR" 4
.IX Item "--without extensión"
Lo contrario de \fB\-\-with\fR, desactiva la extensión dada. Esta opción puede
aparecer más de una vez, o puede enumerar, separadas por comas, varias
extensiones que desactivar.
.IP "\fB\-\-list\fR, \fB\-l\fR" 4
.IX Item "--list, -l"
Lista todas las extensiones disponibles.
.Sp
When called only with this option, \fBdh\fR can be called from any directory
(i.e. it does not need access to files from a source package).
.IP "\fB\-\-no\-act\fR" 4
.IX Item "--no-act"
Muestra las órdenes que se ejecutarían para una secuencia dada, pero no las
ejecuta.
.Sp
Note that dh normally skips running commands that it knows will do nothing.
With \-\-no\-act, the full list of commands in a sequence is printed.
.PP
Las otras opciones introducidas a \fBdh\fR se introducen a cada orden que
ejecuta. Puede utilizar esto para definir una opción como \fB\-v\fR, \fB\-X\fR o
\&\fB\-N\fR, así como opciones más especializadas.
.SH "EJEMPLOS"
.IX Header "EJEMPLOS"
Para ver qué órdenes se incluyen en una secuencia, sin hacer nada en
realidad:
.PP
.Vb 1
\&        dh binary\-arch \-\-no\-act
.Ve
.PP
Este es un fichero «rules» muy sencillo para paquetes donde las secuencias
predeterminadas de órdenes funcionan sin opciones adicionales.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
.Ve
.PP
A menudo, querrá introducir una opción a una orden de debhelper en
particular. La forma sencilla de hacerlo es añadir un objetivo «overrride»
para esa orden.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
\&
\&        override_dh_strip:
\&                dh_strip \-Xfoo
\&
\&        override_dh_auto_configure:
\&                dh_auto_configure \-\- \-\-with\-foo \-\-disable\-bar
.Ve
.PP
En ocasiones, las órdenes automatizadas \fBdh_auto_configure\fR\|(1) y
\&\fBdh_auto_build\fR\|(1) no pueden averiguar qué hacer con un paquete extraño. A
continuación puede ver cómo evitar que se ejecuten para que así pueda
ejecutar sus propias órdenes.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
\&
\&        override_dh_auto_configure:
\&                ./mondoconfig
\&
\&        override_dh_auto_build:
\&                make universe\-explode\-in\-delight
.Ve
.PP
Otra caso común es que desee hacer algo manualmente antes o después de que
se ejecute una orden en particular de debhelper.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
\&
\&        override_dh_fixperms:
\&                dh_fixperms
\&                chmod 4755 debian/foo/usr/bin/foo
.Ve
.PP
Python tools are not run by dh by default, due to the continual change in
that area. Here is how to use \fBdh_python2\fR.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-with python2
.Ve
.PP
A continuación puede ver como forzar el uso del sistema de construcción del
módulo Perl \fBModule::Build\fR, lo cual puede ser necesario si debhelper
detecta erróneamente que el paquete utiliza MakeMaker.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-buildsystem=perl_build
.Ve
.PP
Aquí tiene un ejemplo de cómo sobreescribir la ubicación dónde las órdenes
\&\fBdh_auto_\fR\fI*\fR encuentran el código fuente de un paquete, para un paquete
en el que las fuentes se ubican en un subdirectorio.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-sourcedirectory=src
.Ve
.PP
Y aquí tiene un ejemplo de cómo indicar a las órdenes \fBdh_auto_\fR\fI*\fR que
realicen la construcción en un subdirectorio, que se eliminará mediante
\&\fBclean\fR.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-builddirectory=build
.Ve
.PP
If your package can be built in parallel, please either use compat 10 or
pass \fB\-\-parallel\fR to dh. Then \fBdpkg-buildpackage \-j\fR will work.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-parallel
.Ve
.PP
If your package cannot be built reliably while using multiple threads,
please pass \fB\-\-no\-parallel\fR to dh (or the relevant \fBdh_auto_\fR\fI*\fR
command):
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@ \-\-no\-parallel
.Ve
.PP
A continuación puede ver cómo evitar que \fBdh\fR ejecute varias órdenes que no
desea que se ejecuten. Para ello, defina objetivos «override» vacíos para
cada orden.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
\&
\&        # Órdenes que no se ejecutan:
\&        override_dh_auto_test override_dh_compress override_dh_fixperms:
.Ve
.PP
Puede utilizar «overrides» independientes de la arquitectura para separar un
proceso de construcción largo de un paquete de documentación. Éstos se
omiten al ejecutar las secuencias build-arch y binary-arch.
.PP
.Vb 3
\&        #!/usr/bin/make \-f
\&        %:
\&                dh $@
\&
\&        override_dh_auto_build\-indep:
\&                $(MAKE) \-C docs
\&
\&        # No se requieren comprobaciones para los documentos
\&        override_dh_auto_test\-indep:
\&
\&        override_dh_auto_install\-indep:
\&                $(MAKE) \-C docs install
.Ve
.PP
Continuando con el ejemplo anterior, suponga que necesita ejecutar «chmod»
sobre un fichero, pero solo al construir el paquete dependiente de la
arquitectura, ya que no está presente cuando solo se construye
documentación.
.PP
.Vb 3
\&        override_dh_fixperms\-arch:
\&                dh_fixperms
\&                chmod 4755 debian/foo/usr/bin/foo
.Ve
.SH "FUNCIONAMIENTO INTERNO"
.IX Header "FUNCIONAMIENTO INTERNO"
Si siente curiosidad por el funcionamiento interno de \fBdh\fR, a continuación
puede ver como funciona por dentro.
.PP
In compat 10 (or later), \fBdh\fR creates a stamp file
\&\fIdebian/debhelper\-build\-stamp\fR after the build step(s) are complete to
avoid re-running them.  It is possible to avoid the stamp file by passing
\&\fB\-\-without=build\-stamp\fR to \fBdh\fR.  This makes \*(L"no clean\*(R" builds behave more
like what some people expect at the expense of possibly running the build
and test twice (the second time as root or under \fBfakeroot\fR\|(1)).
.PP
Inside an override target, \fBdh_*\fR commands will create a log file
\&\fIdebian/package.debhelper.log\fR to keep track of which packages the
command(s) have been run for.  These log files are then removed once the
override target is complete.
.PP
In compat 9 or earlier, each debhelper command will record when it's
successfully run in \fIdebian/package.debhelper.log\fR. (Which \fBdh_clean\fR
deletes.) So \fBdh\fR can tell which commands have already been run, for which
packages, and skip running those commands again.
.PP
Each time \fBdh\fR is run (in compat 9 or earlier), it examines the log, and
finds the last logged command that is in the specified sequence. It then
continues with the next command in the sequence.
.PP
Una secuencia también puede ejecutar objetivos dependientes de la
arquitectura en «debian/rules». Por ejemplo, la secuencia «binary» también
ejecuta el objeto «install».
.PP
\&\fBdh\fR utiliza la variable de entorno \fB\s-1DH_INTERNAL_OPTIONS\s0\fR para introducir
información a las órdenes de debhelper que se ejecutan dentro de objetivos
«override». El contenido (e incluso, la existencia) de esta variable de
entorno, como el nombre sugiere, está sujeto a cambios en cualquier momento.
.PP
La opción \fB\-i\fR se introduce a las órdenes en las secuencias
\&\fBbinary-indep\fR, \fBinstall-indep\fR y \fBbinary-indep\fR para asegurar que sólo
actúan sobre paquetes independientes de la arquitectura, y la opción \fB\-a\fR
se introduce a órdenes en las secuencias \fBbuild-arch\fR, \fBinstall-arch\fR y
\&\fBbinary-arch\fR para asegurar que sólo actúan sobre paquetes dependientes de
la arquitectura.
.SH "VÉASE TAMBIÉN"
.IX Header "VÉASE TAMBIÉN"
\&\fBdebhelper\fR\|(7)
.PP
Este programa es parte de debhelper.
.SH "AUTOR"
.IX Header "AUTOR"
Joey Hess <joeyh@debian.org>
.SH "TRADUCTOR"
.IX Header "TRADUCTOR"
Traducci�n de Omar Campagne Polaino
<debian\-l10n\-spanish@lists.debian.org>