/ 
App-PPBuild-0.11
/ Module::Install::PPBuild

NAME

Module::Install::PPBuild - A Module::Install extension for PPBuild based projects.

DESCRIPTION

This extension is used to add rules to the Makefile generated by Module::Install for PPBuild tasks. You can also map PPBuild tasks to MakeMaker rules to override some of the autogenerated rules such as test or install. By default all PPBuild tasks are prefixed with ppbuild_ in the Makefile rule defenition. When a MakeMaker rule is overriden it will simply call the ppbuild_task rule.

SYNOPSIS

Makefile.PL:

use inc::Module::Install;

ppb_prefix 'ppbuild_';

# Load the PPBFile, map PPBuild tasks to MakeMaker rules. ( TASK => RULE );
ppbfile 'PPBFile', 'my_install' => 'install', 'my_test' => 'test';

# Like any Module::Install Makefile.PL.
WriteAll;

HOW IT WORKS

Module::Install uses ExtUtils::MakeMaker to do most of the work. This module makes use of the sub MY::[FUNCTION] {} system to override specified MakeMaker rules replacing them with rules from App::PPBuild::Makefile. It also Adds all the PPBuild tasks as makefile rules with the ppbuild_ prefix. This is done using the MY::postamble() method.

EXPORTED FUNCTIONS

ppb_prefix()

Set the prefix for PPBuild task-rules in the makefile.

ppbfile()

Used to specify the PPBFile to use, as well as which Tasks map to which MakeMaker rules.

# Load the PPBFile, map PPBuild tasks to MakeMaker rules. ( TASK => RULE );
ppbfile 'PPBFile', 'my_install' => 'install', 'my_test' => 'test';

ppbfile(
    'File',
    SomeTask => MakeMaker_Rule,
    ...
);

For a list of MakeMaker rules that can be overridden see the POD for ExtUtils::MM_Unix. The obvious ones are install and test.

PRIVATE FUNCTIONS

task2function()

Used internally to create the MY::rule() function that overrides MakeMaker rules.

AUTHOR

Chad Granum <exodist7@gmail.com>

COPYRIGHT

Copyright 2008 Chad Granum

licensed under the GPL version 3. You should have received a copy of the GNU General Public License along with this. If not, see <http://www.gnu.org/licenses/>.