Module::Install::Build.3pm

Langue: en

Version: 2007-10-31 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NAME

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

VERSION

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

SYNOPSIS

In your Makefile.PL:
     use inc::Module::Install;
     &Build->write;
 
 

DESCRIPTION

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".

VERSION

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.

MAKE TARGETS

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.

SEE ALSO

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

AUTHORS

Audrey Tang <autrijus@autrijus.org>

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

Copyright 2002, 2003, 2004 by Audrey Tang <autrijus@autrijus.org>, Brian Ingerson <ingy@cpan.org>

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>