When you run Makefile.PL, it makes a Makefile. Thats the whole point of
MakeMaker. The Makefile.PL is a simple program which loads
ExtUtils::MakeMaker and runs the WriteMakefile() function to generate a
Heres an example of what you need for a simple module:
NAME is the top-level namespace of your module. VERSION_FROM is the file which contains the $VERSION variable for the entire distribution. Typically this is the same as your top-level module.
A simple listing of all the files in your distribution.
You can write this by hand or generate it with make manifest.
See ExtUtils::Manifest for more details.
|lib/||This is the directory where the .pm and .pod files you wish to have installed go. They are laid out according to namespace. So Foo::Bar is lib/Foo/Bar.pm.|
|t/||Tests for your modules go here. Each test filename ends with a .t. So t/foo.t/ make test will run these tests. The directory is flat, you cannot, for example, have t/foo/bar.t run by make test.|
A log of changes youve made to this module. The layout is free-form.
Heres an example:
|README||A short description of your module, what it does, why someone would use it and its limitations. CPAN automatically pulls your README file out of the archive and makes it available to CPAN users, it is the first thing they will read to decide if your module is right for them.|
|INSTALL||Instructions on how to install your module along with any dependencies. Suggested information to include here:|
A file full of regular expressions to exclude when using make
manifest to generate the MANIFEST. These regular expressions
are checked against each file path found in the distribution (so
youre matching against t/foo.t not foo.t).
Heres a sample:
Since # can be used for comments, # must be escaped.
MakeMaker comes with a default MANIFEST.SKIP to avoid things like version control directories and backup files. Specifying your own will override this default.
perlmodstyle gives stylistic help writing a module.
perlnewmod gives more information about how to write a module.
|perl v5.20.3||EXTUTILS::MAKEMAKER::TUTORIAL (3)||2015-09-10|