DH-DIST-ZILLA

NAME

dh-dist-zilla - debhelper add-on to run dzil (Dist::Zilla) during build

DESCRIPTION

The dh-dist-zilla package provides a sequence addon for debhelper 7 and above which can be used in the following two ways:

In "debian/rules" since debhelper 7:

#!/usr/bin/make -f
export DH_VERBOSE=1
%:
dh $@ --with dist-zilla

Since debhelper 11.4 alternatively also just in "debian/control":

Build-Depends: dh-sequence-dist-zilla

Both variants will call "dzil build" prior to "dh_auto_configure", "dzil clean" before "dh_clean" and will add the option "-D build-directory" to "dh_auto_configure", "dh_auto_build", "dh_auto_install", and "dh_auto_test".

How to generate the .orig.tar.xz "upstream" tar-ball

A ‘debian/rules‘ file as mentioned above also provides a ‘get-orig-source‘ target to generate a source tar ball which contains the minimal necessary contents (compared to the contents of tar-ball for CPAN which would require some additional, generated meta data files):

make -f debian/rules get-orig-source

Or if your ‘debian/rules‘ file is executable, you can also just call it like this:

debian/rules get-orig-source

If you want to type even less, there’s also a ‘origtar‘ alias (named after the ‘origtargz‘ script from the ‘devscripts‘ package) for this target:

debian/rules origtar

SEE ALSO

debhelper(7), dh(1), dzil(1), dh_dzil_build(1), dh_dzil_clean(1), dh_dist_zilla_origtar(1)

AUTHOR

Elmar Heeb <elmar@heebs.ch> and Axel Beckert <abe@debian.org>