1Module::Install::MakefiUlsee(r3)Contributed Perl DocumenMtoadtuiloen::Install::Makefile(3)
2
3
4
6 Module::Install::MakeMaker - Extension Rules for ExtUtils::MakeMaker
7
9 In your Makefile.PL:
10
11 use inc::Module::Install;
12 WriteMakefile();
13
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
25 This module also adds some Configuration parameters of its own:
26
27 NAME
28 The NAME parameter is required by ExtUtils::MakeMaker. If you have a
29 single module in your distribution, or if the module name indicated by
30 the current directory exists under lib/, this module will use the
31 guessed package name as the default.
32
33 If this module can't find a default for "NAME" it will ask you to
34 specify it manually.
35
36 VERSION
37 ExtUtils::MakeMaker requires either the "VERSION" or "VERSION_FROM"
38 parameter. If this module can guess the package's "NAME", it will
39 attempt to parse the "VERSION" from it.
40
41 If this module can't find a default for "VERSION" it will ask you to
42 specify it manually.
43
45 ExtUtils::MakeMaker provides you with many useful "make" targets. A
46 "make" target is the word you specify after "make", like "test" for
47 "make test". Some of the more useful targets are:
48
49 • all
50
51 This is the default target. When you type "make" it is the same as
52 entering "make all". This target builds all of your code and stages
53 it in the "blib" directory.
54
55 • test
56
57 Run your distribution's test suite.
58
59 • install
60
61 Copy the contents of the "blib" directory into the appropriate
62 directories in your Perl installation.
63
64 • dist
65
66 Create a distribution tarball, ready for uploading to CPAN or
67 sharing with a friend.
68
69 • clean distclean purge
70
71 Remove the files created by "perl Makefile.PL" and "make".
72
73 • help
74
75 Same as typing "perldoc ExtUtils::MakeMaker".
76
77 This module modifies the behaviour of some of these targets, depending
78 on your requirements, and also adds the following targets to your
79 Makefile:
80
81 • cpurge
82
83 Just like purge, except that it also deletes the files originally
84 added by this module itself.
85
86 • chelp
87
88 Short cut for typing "perldoc Module::Install".
89
90 • distsign
91
92 Short cut for typing "cpansign -s", for Module::Signature users to
93 sign the distribution before release.
94
96 Module::Install, CPAN::MakeMaker, CPAN::MakeMaker::Philosophy
97
99 Adam Kennedy <adamk@cpan.org>
100
101 Audrey Tang <autrijus@autrijus.org>
102
103 Brian Ingerson <INGY@cpan.org>
104
106 Some parts copyright 2008 - 2012 Adam Kennedy.
107
108 Copyright 2002, 2003, 2004 Audrey Tang and Brian Ingerson.
109
110 This program is free software; you can redistribute it and/or modify it
111 under the same terms as Perl itself.
112
113
114
115perl v5.38.0 2023-07-20 Module::Install::Makefile(3)