Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

ExtUtils::Command::MM (3)

Name

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

Synopsis

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

Description

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



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.



ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+-----------------------+
       |ATTRIBUTE TYPE |   ATTRIBUTE VALUE     |
       +---------------+-----------------------+
       |Availability   | runtime/perl-532      |
       +---------------+-----------------------+
       |Stability      | Pass-through volatile |
       +---------------+-----------------------+

NOTES
       Source code for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at
       https://github.com/oracle/solaris-userland.  The original community
       source was downloaded from
       http://www.cpan.org/src/5.0/perl-5.32.0.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.perl.org/.



perl v5.32.0                      2020-06-14          ExtUtils::Command::MM(3)