GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  MODULE::INSTALL::MAKEFILE (3)

.ds Aq ’

NAME

Module::Install::MakeMaker - Extension Rules for ExtUtils::MakeMaker

CONTENTS

SYNOPSIS

In your Makefile.PL:



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



DESCRIPTION

This module is a wrapper around <B>ExtUtils::MakeMakerB>. 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 <B>ExtUtils::MakeMakerB>. 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

<B>ExtUtils::MakeMakerB> 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

<B>ExtUtils::MakeMakerB> provides you with many useful make targets. A make <B>targetB> is the word you specify after make, like test for make test. Some of the more useful targets are:
o 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.

o test

Run your distribution’s test suite.

o install

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

o dist

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

o clean distclean purge

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

o 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:
o cpurge

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

o chelp

Short cut for typing perldoc Module::Install.

o distsign

Short cut for typing cpansign -s, for <B>Module::SignatureB> 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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 MODULE::INSTALL::MAKEFILE (3) 2015-05-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.