perldoc > ExtUtils::Command::MM

man perldoc info pydoc3 ri search

📛 NAME

ExtUtils::Command::MM - Commands for the MM's to use in Makefiles

🚀 Quick Reference

Use Case	Command	Description
🧪 Run tests	test_harness($verbose, @test_libs)	Runs tests via Test::Harness with libraries
📄 POD to man	pod2man('--option', $pod => $man, ...)	Convert POD files to manpages, supports --perm_rw
⚠️ Warn old packlist	perl -MExtUtils::Command::MM -e warn_if_old_packlist <file>	Warn about an old packlist file
📥 perllocal install	perl -M... -e perllocal_install <type> <mod> <key> <val>...	Print POD fragment for perllocal.pod
🗑️ Uninstall	perl -M... -e uninstall <packlist>	Wrapper (deprecated warning, no actual removal)
📌 Test non‑empty	perl -M... -e test_s <file>	Exit 0 if file non‑empty, 1 otherwise
📋 Copy non‑empty	perl -M... -e cp_nonempty <src> <dst> <perm>	Copy file only if non‑empty, with permissions

📋 SYNOPSIS

perl "-MExtUtils::Command::MM" -e "function" "--" arguments...

📖 DESCRIPTION

FOR INTERNAL USE ONLY! The interface is not stable.

ExtUtils::Command::MM encapsulates code which would otherwise have to be done with large "one" liners.

Any $(FOO) used in the examples are make variables, not Perl.

🔧 test_harness

test_harness($verbose, @test_libs);

Runs the tests on @ARGV via Test::Harness passing through the $verbose flag. Any @test_libs will be unshifted onto the test's @INC.

@test_libs are run in alphabetical order.

🔧 pod2man

pod2man( '--option=value',
         $podfile1 => $manpage1,
         $podfile2 => $manpage2,
         ...
       );

# or args on @ARGV

pod2man() is a function performing most of the duties of the pod2man program. Its arguments are exactly the same as pod2man as of 5.8.0 with the addition of:

• --perm_rw octal permission to set the resulting manpage to

And the removal of:

• --verbose/-v
• --help/-h

If no arguments are given to pod2man it will read from @ARGV.

If Pod::Man is unavailable, this function will warn and return undef.

🔧 warn_if_old_packlist

perl "-MExtUtils::Command::MM" -e warn_if_old_packlist <somefile>

Displays a warning that an old packlist file was found. Reads the filename from @ARGV.

🔧 perllocal_install

perl "-MExtUtils::Command::MM" -e perllocal_install
    <type> <module name> <key> <value> ...

# VMS only, key|value pairs come on STDIN
perl "-MExtUtils::Command::MM" -e perllocal_install
    <type> <module name> < <key>|<value> ...

Prints a fragment of POD suitable for appending to perllocal.pod. Arguments are read from @ARGV.

'type' is the type of what you're installing. Usually 'Module'.

'module name' is simply the name of your module. (Foo::Bar)

Key/value pairs are extra information about the module. Fields include:

• installed into which directory your module was put into
• LINKTYPE dynamic or static linking
• VERSION module version number
• EXE_FILES any executables installed in a space separated list

🔧 uninstall

perl "-MExtUtils::Command::MM" -e uninstall <packlist>

A wrapper around ExtUtils::Install::uninstall(). Warns that uninstallation is deprecated and doesn't actually perform the uninstallation.

🔧 test_s

perl "-MExtUtils::Command::MM" -e test_s <file>

Tests if a file exists and is not empty (size > 0). Exits with 0 if it does, 1 if it does not.

🔧 cp_nonempty

perl "-MExtUtils::Command::MM" -e cp_nonempty <srcfile> <dstfile> <perm>

Tests if the source file exists and is not empty (size > 0). If it is not empty it copies it to the given destination with the given permissions.

📛 NAME 🚀 Quick Reference 📋 SYNOPSIS 📖 DESCRIPTION