1Module::Install::MakefiUlsee(r3)Contributed Perl DocumenMtoadtuiloen::Install::Makefile(3)
2
3
4

NAME

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

SYNOPSIS

9       In your Makefile.PL:
10
11           use inc::Module::Install;
12           WriteMakefile();
13

DESCRIPTION

15       This module is a wrapper around ExtUtils::MakeMaker.  It exports two
16       functions: "prompt" (an alias for "ExtUtils::MakeMaker::prompt") and
17       "WriteMakefile".
18
19       The "WriteMakefile" function will pass on keyword/value pair functions
20       to "ExtUtils::MakeMaker::WriteMakefile". The required parameters "NAME"
21       and "VERSION" (or "VERSION_FROM") are not necessary if it can find them
22       unambiguously in your code.
23

CONFIGURATION OPTIONS

25       This module also adds some Configuration parameters of its own:
26
27       NAME
28
29       The NAME parameter is required by ExtUtils::MakeMaker. If you have a
30       single module in your distribution, or if the module name indicated by
31       the current directory exists under lib/, this module will use the
32       guessed package name as the default.
33
34       If this module can't find a default for "NAME" it will ask you to spec‐
35       ify it manually.
36
37       VERSION
38
39       ExtUtils::MakeMaker requires either the "VERSION" or "VERSION_FROM"
40       parameter.  If this module can guess the package's "NAME", it will
41       attempt to parse the "VERSION" from it.
42
43       If this module can't find a default for "VERSION" it will ask you to
44       specify it manually.
45

MAKE TARGETS

47       ExtUtils::MakeMaker provides you with many useful "make" targets. A
48       "make" target is the word you specify after "make", like "test" for
49       "make test". Some of the more useful targets are:
50
51       * all
52           This is the default target. When you type "make" it is the same as
53           entering "make all". This target builds all of your code and stages
54           it in the "blib" directory.
55
56       * test
57           Run your distribution's test suite.
58
59       * install
60           Copy the contents of the "blib" directory into the appropriate
61           directories in your Perl installation.
62
63       * dist
64           Create a distribution tarball, ready for uploading to CPAN or shar‐
65           ing with a friend.
66
67       * clean distclean purge
68           Remove the files created by "perl Makefile.PL" and "make".
69
70       * help
71           Same as typing "perldoc ExtUtils::MakeMaker".
72
73       This module modifies the behaviour of some of these targets, depending
74       on your requirements, and also adds the following targets to your Make‐
75       file:
76
77       * cpurge
78           Just like purge, except that it also deletes the files originally
79           added by this module itself.
80
81       * chelp
82           Short cut for typing "perldoc Module::Install".
83
84       * distsign
85           Short cut for typing "cpansign -s", for Module::Signature users to
86           sign the distribution before release.
87

SEE ALSO

89       Module::Install, CPAN::MakeMaker, CPAN::MakeMaker::Philosophy
90

AUTHORS

92       Audrey Tang <autrijus@autrijus.org>
93
94       Based on original works by Brian Ingerson <INGY@cpan.org>
95

97       Copyright 2002, 2003, 2004 by Audrey Tang <autrijus@autrijus.org>,
98       Brian Ingerson <ingy@cpan.org>
99
100       This program is free software; you can redistribute it and/or modify it
101       under the same terms as Perl itself.
102
103       See <http://www.perl.com/perl/misc/Artistic.html>
104
105
106
107perl v5.8.8                       2007-03-05      Module::Install::Makefile(3)
Impressum