GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  EXTUTILS::COMMAND::MM (3)

.ds Aq ’

NAME

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

CONTENTS

SYNOPSIS



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



DESCRIPTION

<B>FOR INTERNAL USE ONLY!B> 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.
<B>test_harnessB>


  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.

<B>pod2manB>


  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.

<B>warn_if_old_packlistB>


  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.

<B>perllocal_installB>


    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 seperated
                        list



<B>uninstallB>


    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.

<B>test_sB>


   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.

<B>cp_nonemptyB>


  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.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 EXTUTILS::COMMAND::MM (3) 2015-09-10

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.