NAME
Module::Install::MakeMaker - Extension Rules for ExtUtils::MakeMaker
SYNOPSIS
In your Makefile.PL:
use inc::Module::Install;
WriteMakefile();
DESCRIPTION
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.
CONFIGURATION OPTIONS
This module also adds some Configuration parameters of its own:
NAME
The NAME parameter is required by ExtUtils::MakeMaker. If you have a single module in your distribution, or if the module name indicated by the current directory exists under lib/, this module will use the guessed package name as the default.
If this module can't find a default for NAME it will ask you to specify it manually.
VERSION
ExtUtils::MakeMaker 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.
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
makeit is the same as enteringmake all. This target builds all of your code and stages it in theblibdirectory.test
Run your distribution's test suite.
install
Copy the contents of the
blibdirectory 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.PLandmake.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.
SEE ALSO
Module::Install, CPAN::MakeMaker, CPAN::MakeMaker::Philosophy
AUTHORS
Adam Kennedy <adamk@cpan.org>
Audrey Tang <autrijus@autrijus.org>
Brian Ingerson <INGY@cpan.org>
COPYRIGHT
Some parts copyright 2008 - 2012 Adam Kennedy.
Copyright 2002, 2003, 2004 Audrey Tang and Brian Ingerson.
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.