NAME

Dist::Zilla::Plugin::MakeMaker - build a Makefile.PL that uses ExtUtils::MakeMaker

VERSION

version 6.031

DESCRIPTION

This plugin will produce an ExtUtils::MakeMaker-powered Makefile.PL for the distribution. If loaded, the Manifest plugin should also be loaded.

PERL VERSION

This module should work on any version of perl still receiving updates from the Perl 5 Porters. This means it should work on any version of perl released in the last two to three years. (That is, if the most recently released version is v5.40, then this module should work on both v5.40 and v5.38.)

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

ATTRIBUTES

eumm_version

This option declares the version of ExtUtils::MakeMaker required to configure and build the distribution. There is no default, although one may be added if it can be determined that the generated Makefile.PL requires some specific minimum. No testing has been done on this front.

make_path

This option sets the path to make, used to build your dist and run tests. It defaults to the value for make in Config, or to make if that isn't set.

You probably won't need to set this option.

main_module

This option sets the name of the main module in your dist. It defaults to the name derived from the distribution's name after replacing - with ::, (e.g. Foo::Bar for distribution Foo-Bar). The value is set as a NAME argument for WriteMakefile.

You want to use this option when the name of distribution doesn't reflect any module names contained in your distribution e.g. LWP vs libwww-perl.

static_attribution

This option omits the version number in the "generated by" comment in the Makefile.PL. For setups that copy the Makefile.PL back to the repo, this avoids churn just from upgrading Dist::Zilla.

SEE ALSO

Core Dist::Zilla plugins: @Basic, ModuleBuild, Manifest.

Dist::Zilla roles: BuildRunner, InstallTool, PrereqSource, TestRunner.

AUTHOR

Ricardo SIGNES 😏 <cpan@semiotic.systems>

COPYRIGHT AND LICENSE

This software is copyright (c) 2023 by Ricardo SIGNES.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.