dwww Home | Manual pages | Find package

ExtUti...and::MM(3perl) Perl Programmers Reference GuideExtUti...and::MM(3perl)

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

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

perl v5.40.1                       2026-08-30           ExtUti...and::MM(3perl)

Generated by dwww version 1.16 on Sat Oct 3 07:43:40 CEST 2026.