++ed by:

10 PAUSE users
7 non-PAUSE users.

and 1 contributors


Module::Install::Build - Extension Rules for Module::Build


This document describes version 0.01 of Module::Install::Build, released March 1, 2003.


In your Makefile.PL:

    use inc::Module::Install;


This module is a wrapper around Module::Build.

The &Build-write> function will pass on keyword/value pair functions to Module::Build::create_build_script.


Module::Build requires either the VERSION or VERSION_FROM parameter. If this module can guess the package's NAME, it will attempt to parse the VERSION from it.

If this module can't find a default for VERSION it will ask you to specify it manually.


Module::Build 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 Module::Build.

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.


Module::Install, CPAN::MakeMaker, CPAN::MakeMaker-Philosophy


Autrijus Tang <autrijus@autrijus.org>

Based on original works by Brian Ingerson <INGY@cpan.org>


Copyright 2003 by Autrijus Tang <autrijus@autrijus.org>. Copyright (c) 2002. Brian Ingerson. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html