dh-make-perl(1)

dh-make-perl1

Create debian source packages from perl modules

Usage

dh-make-perl [{SOURCE_DIR | --cpan MODULE}]

dh-make-perl --refresh

You can modify dh-make-perl's behaviour with some switches:

Overview

dh-make-perl will create the files required to build a debian source package out of a perl package. This works for most simple packages and is also useful for getting started with packaging perl modules.

You can specify a module name with the --cpan switch and dh-make-perl will download the module for you from a CPAN mirror, or you can specify the directory with the already unpacked sources. If neither --cpan nor a directory is given as argument, dh-make-perl tries to create a perl package from the data in .

There is an override mechanism in place to handle most of the little changes that may be needed for some modules (this hasn't been tested much, though, and the override database needs to be filled in).

You can build and install the debian package using the --build and --install command line switches.

Using this program is no excuse for not reading the debian developer documentation, including the Debian policy, the perl policy, the packaging manual and so on.

Files

The following directories will be searched to find additional files required by dh-make-perl:

        /usr/share/dh-make-perl/
        $HOME/.dh-make-perl/
•

overrides

File that overrides information retreived (or guessed) about the package. All the files in the library directories are loaded: entries in the home take precedence. See the distributed overrides file for usage information.

•

rules.MakeMaker.noxs

A debian/rules makefile for modules that use ExtUtils::MakeMaker, but don't have C/XS code.

•

rules.MakeMaker.xs

A debian/rules makefile for modules that use ExtUtils::MakerMaker and C/XS code.

•

rules.Module-Build.noxs

A debian/rules makefile for modules that use Module::Build, but don't have C/XS code.

•

rules.Module-Build.xs

A debian/rules makefile for modules that use Module::Build and C/XS code.

Environment

HOME - get user's home directory

DEBFULLNAME - get the real name of the maintainer

LOGNAME or USER - get the username

DEBEMAIL or EMAIL - get the email address of the user

Pod errors

Hey! The above document had some coding errors, which are explained below:

Around line 1403:

'=item' outside of any '=over'

Releases

4 releases since Debian 3.0 (Woody); the text changed 3 times.

  1. 3.0
  2. 3.1
  3. 4.0
  4. 5.0