Module:...Makefile(3)

💅 Module::Install::MakeMaker — Extension Rules for ExtUtils::MakeMaker ✨

okay so bestie, you're reading a User Contributed Perl Documentation page for Module:...Makefile(3) and honestly? it's giving "short but mighty" 🎀 let's get into it.

---

🌸 SYNOPSIS 🌸

in your Makefile.PL, you literally just do this:

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

that's it. that's the whole vibe. slay 💅

---

🦋 DESCRIPTION 🦋

so this module is a cute lil wrapper around ExtUtils::MakeMaker — like it's the bestie that handles the small talk for you 🫶

it exports two functions:

• prompt — which is literally just an alias for ExtUtils::MakeMaker::prompt
• WriteMakefile — the main character 👑

here's the tea on WriteMakefile: it passes on keyword/value pair functions straight to ExtUtils::MakeMaker::WriteMakefile. and the required parameters NAME and VERSION (or VERSION_FROM) are not necessary if it can find them unambiguously in your code. no cap, it'll just figure it out ✨

---

🎀 CONFIGURATION OPTIONS 🎀

this module also adds some Configuration parameters of its own, and they're lowkey iconic:

💖 NAME

NAME is required by ExtUtils::MakeMaker, periodt. but here's the thing — 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 🧚

and if it can't find a default for NAME? it will just ask you to specify it manually. awkward but make it work 🙈

💜 VERSION

ExtUtils::MakeMaker requires either the VERSION or VERSION_FROM parameter — no skipping that one.

but if this module can guess the package's NAME, it will attempt to parse the VERSION from it 🔥

and if it can't find a default for VERSION? yep, it asks you to specify it manually. same energy 💀

---

🌈 MAKE TARGETS 🌈

ExtUtils::MakeMaker provides you with many useful make targets. a "make target" is just the word you specify after make — like test for make test. highkey useful. some of the more useful targets are:

• all — this is the default target. when you type make it's the same as entering make all. this target builds all of your code and stages it in the blib directory. iconic behaviour 🫶
• test — run your distribution's test suite. go off bestie 🌸
• install — copy the contents of the blib directory into the appropriate directories in your Perl installation.
• dist — create a distribution tarball, ready for uploading to CPAN or sharing with a friend 💖
• clean distclean purge — remove the files created by perl Makefile.PL and make.
• help — same as typing perldoc ExtUtils::MakeMaker.

now this module modifies the behaviour of some of these targets, depending on your requirements, and also adds the following targets to your Makefile 👑:

• cpurge — just like purge, except that it also deletes the files originally added by this module itself. self-aware king behaviour 💅
• chelp — short cut for typing perldoc Module::Install.
• distsign — short cut for typing cpansign -s, for Module::Signature users to sign the distribution before release ✨

---

🦋 SEE ALSO 🦋

• Module::Install
• CPAN::MakeMaker
• CPAN::MakeMaker::Philosophy

go read them, iykyk 📚

---

🫶 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.

fr fr, it's free software — share it, remix it, just keep the same terms as Perl itself 💖

---

⭐ and that's the whole page bestie! this doc ships with perl v5.42.0, dated 2023-04-29 — thanks for reading, mwah 💋✨