--with
addon[,
addon ...]
Add the debhelper commands specified by the given addon to
appropriate places in the sequence of commands that is run.
This option can be repeated more than once, or multiple
addons can be listed, separated by commas. This is used when
there is a third-party package that provides debhelper
commands. See the PROGRAMMING file for documentation about
the sequence addon interface.
A Build-Depends
relation on the package dh-sequence-
addon
implies a --with
addon. This avoids the need for an explicit
--with
in debian/rules that only duplicates what is already
declared via the build dependencies in debian/control. 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
bootstrapping).
Since debhelper 12.5, addons can also be activated in
indep
-only mode (via Build-Depends-Indep
) or arch
-only mode
(via Build-Depends-Arch
). Such addons are only active in the
particular sequence (e.g. binary-indep
) which simplifies
dependency management for cross-builds.
Please note that addons activated via Build-Depends-Indep
or
Build-Depends-Arch
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 Build-Depends
(or manually via debian/rules).
Currently, such addons can only add commands to sequences.
--without
addon
The inverse of --with
, disables using the given addon. This
option can be repeated more than once, or multiple addons to
disable can be listed, separated by commas.
--list
, -l
List all available addons.
When called only with this option, dh
can be called from any
directory (i.e. it does not need access to files from a
source package).
--no-act
Prints commands that would run for a given sequence, but does
not run them.
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.
Other options passed to dh
are passed on to each command it runs.
This can be used to set an option like -v
or -X
or -N
, as well as
for more specialised options.