mingw/html/lib/ExtUtils/Command/MM.html

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   3 <html xmlns="http://www.w3.org/1999/xhtml">
   4 <head>
   5 <title>ExtUtils::Command::MM - Commands for the MM's to use in Makefiles</title>
   6 <meta http-equiv="content-type" content="text/html; charset=utf-8" />
   7 <link rev="made" href="mailto:" />
   8 </head>
   9
  10 <body style="background-color: white">
  11 <table border="0" width="100%" cellspacing="0" cellpadding="3">
  12 <tr><td class="block" style="background-color: #cccccc" valign="middle">
  13 <big><strong><span class="block">&nbsp;ExtUtils::Command::MM - Commands for the MM's to use in Makefiles</span></strong></big>
  14 </td></tr>
  15 </table>
  16
  17 <p><a name="__index__"></a></p>
  18 <!-- INDEX BEGIN -->
  19
  20 <ul>
  21
  22         <li><a href="#name">NAME</a></li>
  23         <li><a href="#synopsis">SYNOPSIS</a></li>
  24         <li><a href="#description">DESCRIPTION</a></li>
  25 </ul>
  26 <!-- INDEX END -->
  27
  28 <hr />
  29 <p>
  30 </p>
  31 <h1><a name="name">NAME</a></h1>
  32 <p>ExtUtils::Command::MM - Commands for the MM's to use in Makefiles</p>
  33 <p>
  34 </p>
  35 <hr />
  36 <h1><a name="synopsis">SYNOPSIS</a></h1>
  37 <pre>
  38   perl &quot;-MExtUtils::Command::MM&quot; -e &quot;function&quot; &quot;--&quot; arguments...</pre>
  39 <p>
  40 </p>
  41 <hr />
  42 <h1><a name="description">DESCRIPTION</a></h1>
  43 <p><strong>FOR INTERNAL USE ONLY!</strong>  The interface is not stable.</p>
  44 <p>ExtUtils::Command::MM encapsulates code which would otherwise have to
  45 be done with large ``one'' liners.</p>
  46 <p>Any $(FOO) used in the examples are make variables, not Perl.</p>
  47 <dl>
  48 <dt><strong><a name="item_test_harness"><strong>test_harness</strong></a></strong>
  49
  50 <dd>
  51 <pre>
  52   test_harness($verbose, @test_libs);</pre>
  53 </dd>
  54 <dd>
  55 <p>Runs the tests on @ARGV via Test::Harness passing through the $verbose
  56 flag.  Any @test_libs will be unshifted onto the test's @INC.</p>
  57 </dd>
  58 <dd>
  59 <p>@test_libs are run in alphabetical order.</p>
  60 </dd>
  61 <dt><strong><a name="item_pod2man"><strong>pod2man</strong></a></strong>
  62
  63 <dd>
  64 <pre>
  65   pod2man( '--option=value',
  66            $podfile1 =&gt; $manpage1,
  67            $podfile2 =&gt; $manpage2,
  68            ...
  69          );</pre>
  70 </dd>
  71 <dd>
  72 <pre>
  73   # or args on @ARGV</pre>
  74 </dd>
  75 <dd>
  76 <p><a href="#item_pod2man"><code>pod2man()</code></a> is a function performing most of the duties of the pod2man
  77 program.  Its arguments are exactly the same as pod2man as of 5.8.0
  78 with the addition of:</p>
  79 </dd>
  80 <dd>
  81 <pre>
  82     --perm_rw   octal permission to set the resulting manpage to</pre>
  83 </dd>
  84 <dd>
  85 <p>And the removal of:</p>
  86 </dd>
  87 <dd>
  88 <pre>
  89     --verbose/-v
  90     --help/-h</pre>
  91 </dd>
  92 <dd>
  93 <p>If no arguments are given to pod2man it will read from @ARGV.</p>
  94 </dd>
  95 <dt><strong><a name="item_warn_if_old_packlist"><strong>warn_if_old_packlist</strong></a></strong>
  96
  97 <dd>
  98 <pre>
  99   perl &quot;-MExtUtils::Command::MM&quot; -e warn_if_old_packlist &lt;somefile&gt;</pre>
 100 </dd>
 101 <dd>
 102 <p>Displays a warning that an old packlist file was found.  Reads the
 103 filename from @ARGV.</p>
 104 </dd>
 105 <dt><strong><a name="item_perllocal_install"><strong>perllocal_install</strong></a></strong>
 106
 107 <dd>
 108 <pre>
 109     perl &quot;-MExtUtils::Command::MM&quot; -e perllocal_install
 110         &lt;type&gt; &lt;module name&gt; &lt;key&gt; &lt;value&gt; ...</pre>
 111 </dd>
 112 <dd>
 113 <pre>
 114     # VMS only, key|value pairs come on STDIN
 115     perl &quot;-MExtUtils::Command::MM&quot; -e perllocal_install
 116         &lt;type&gt; &lt;module name&gt; &lt; &lt;key&gt;|&lt;value&gt; ...</pre>
 117 </dd>
 118 <dd>
 119 <p>Prints a fragment of POD suitable for appending to perllocal.pod.
 120 Arguments are read from @ARGV.</p>
 121 </dd>
 122 <dd>
 123 <p>'type' is the type of what you're installing.  Usually 'Module'.</p>
 124 </dd>
 125 <dd>
 126 <p>'module name' is simply the name of your module.  (Foo::Bar)</p>
 127 </dd>
 128 <dd>
 129 <p>Key/value pairs are extra information about the module.  Fields include:</p>
 130 </dd>
 131 <dd>
 132 <pre>
 133     installed into      which directory your module was out into
 134     LINKTYPE            dynamic or static linking
 135     VERSION             module version number
 136     EXE_FILES           any executables installed in a space seperated
 137                         list</pre>
 138 </dd>
 139 <dt><strong><a name="item_uninstall"><strong>uninstall</strong></a></strong>
 140
 141 <dd>
 142 <pre>
 143     perl &quot;-MExtUtils::Command::MM&quot; -e uninstall &lt;packlist&gt;</pre>
 144 </dd>
 145 <dd>
 146 <p>A wrapper around ExtUtils::Install::uninstall().  Warns that
 147 uninstallation is deprecated and doesn't actually perform the
 148 uninstallation.</p>
 149 </dd>
 150 </dl>
 151 <table border="0" width="100%" cellspacing="0" cellpadding="3">
 152 <tr><td class="block" style="background-color: #cccccc" valign="middle">
 153 <big><strong><span class="block">&nbsp;ExtUtils::Command::MM - Commands for the MM's to use in Makefiles</span></strong></big>
 154 </td></tr>
 155 </table>
 156
 157 </body>
 158
 159 </html>