ExtUtils::Command::MM(3p) Perl Programmers Reference Guide

ExtUtils::Command::MM(3p) Perl Programmers Reference Guide #

ExtUtils::Command::MM(3p) Perl Programmers Reference Guide

NNAAMMEE #

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

SSYYNNOOPPSSIISS #

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

DDEESSCCRRIIPPTTIIOONN #

 FFOORR IINNTTEERRNNAALL UUSSEE OONNLLYY!!  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.

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

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

       # or args on @ARGV

     ppoodd22mmaann(()) 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.

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

 ppeerrllllooccaall__iinnssttaallll
         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

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

     A wrapper around EExxttUUttiillss::::IInnssttaallll::::uunniinnssttaallll(()).  Warns that
     uninstallation is deprecated and doesn't actually perform the
     uninstallation.

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

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

 ccpp__nnoonneemmppttyy
       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.36.3 2023-02-15 ExtUtils::Command::MM(3p)