Module::Install::Makefile3pm

Usage

    use inc::Module::Install;
    WriteMakefile();

Overview

This module is a wrapper around ExtUtils::MakeMaker. It exports two functions: "prompt" (an alias for "ExtUtils::MakeMaker::prompt") and "WriteMakefile".

The "WriteMakefile" function will pass on keyword/value pair functions to "ExtUtils::MakeMaker::WriteMakefile". The required parameters "NAME" and "VERSION" (or "VERSION_FROM") are not necessary if it can find them unambiguously in your code.

Options

This module also adds some Configuration parameters of its own:

Make targets

ExtUtils::MakeMaker provides you with many useful "make" targets. A "make" target is the word you specify after "make", like "test" for "make test". Some of the more useful targets are:

•

all

This is the default target. When you type "make" it is the same as entering "make all". This target builds all of your code and stages it in the "blib" directory.

•

test

Run your distribution's test suite.

•

install

Copy the contents of the "blib" directory into the appropriate directories in your Perl installation.

•

dist

Create a distribution tarball, ready for uploading to CPAN or sharing with a friend.

•

clean distclean purge

Remove the files created by "perl Makefile.PL" and "make".

•

help

Same as typing "perldoc ExtUtils::MakeMaker".

This module modifies the behaviour of some of these targets, depending on your requirements, and also adds the following targets to your Makefile:

•

cpurge

Just like purge, except that it also deletes the files originally added by this module itself.

•

chelp

Short cut for typing "perldoc Module::Install".

•

distsign

Short cut for typing "cpansign -s", for Module::Signature users to sign the distribution before release.