---
name: "dh-dist-zilla"
section: "7"
platform: "linux"
package: "dh-dist-zilla"
version: "1.4.1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/dh-dist-zilla"
---

# dh-dist-zilla(7)

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

## 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)](/debhelper/7.md), [**dh**(1)](/dh/1.md), **dzil**(1), [**dh\_dzil\_build**(1)](/dh_dzil_build/1.md), [**dh\_dzil\_clean**(1)](/dh_dzil_clean/1.md), [**dh\_dist\_zilla\_origtar**(1)](/dh_dist_zilla_origtar/1.md)

## AUTHOR

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