mingw/html/lib/ExtUtils/MM_Win32.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::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker</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::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker</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
  27                 <li><a href="#overridden_methods">Overridden methods</a></li>
  28         </ul>
  29
  30 </ul>
  31 <!-- INDEX END -->
  32
  33 <hr />
  34 <p>
  35 </p>
  36 <h1><a name="name">NAME</a></h1>
  37 <p>ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker</p>
  38 <p>
  39 </p>
  40 <hr />
  41 <h1><a name="synopsis">SYNOPSIS</a></h1>
  42 <pre>
  43  use ExtUtils::MM_Win32; # Done internally by ExtUtils::MakeMaker if needed</pre>
  44 <p>
  45 </p>
  46 <hr />
  47 <h1><a name="description">DESCRIPTION</a></h1>
  48 <p>See ExtUtils::MM_Unix for a documentation of the methods provided
  49 there. This package overrides the implementation of these methods, not
  50 the semantics.</p>
  51 <p>
  52 </p>
  53 <h2><a name="overridden_methods">Overridden methods</a></h2>
  54 <dl>
  55 <dt><strong><a name="item_dlsyms"><strong>dlsyms</strong></a></strong>
  56
  57 <dt><strong><a name="item_replace_manpage_separator">replace_manpage_separator</a></strong>
  58
  59 <dd>
  60 <p>Changes the path separator with .</p>
  61 </dd>
  62 </li>
  63 <dt><strong><a name="item_maybe_command"><strong>maybe_command</strong></a></strong>
  64
  65 <dd>
  66 <p>Since Windows has nothing as simple as an executable bit, we check the
  67 file extension.</p>
  68 </dd>
  69 <dd>
  70 <p>The PATHEXT env variable will be used to get a list of extensions that
  71 might indicate a command, otherwise .com, .exe, .bat and .cmd will be
  72 used by default.</p>
  73 </dd>
  74 </li>
  75 <dt><strong><a name="item_init_dirfilesep"><strong>init_DIRFILESEP</strong></a></strong>
  76
  77 <dd>
  78 <p>Using \ for Windows.</p>
  79 </dd>
  80 </li>
  81 <dt><strong><a name="item_init_others"><strong>init_others</strong></a></strong>
  82
  83 <dd>
  84 <p>Override some of the Unix specific commands with portable
  85 ExtUtils::Command ones.</p>
  86 </dd>
  87 <dd>
  88 <p>Also provide defaults for LD and AR in case the %Config values aren't
  89 set.</p>
  90 </dd>
  91 <dd>
  92 <p>LDLOADLIBS's default is changed to $Config{libs}.</p>
  93 </dd>
  94 <dd>
  95 <p>Adjustments are made for Borland's quirks needing -L to come first.</p>
  96 </dd>
  97 </li>
  98 <dt><strong><a name="item_init_platform">init_platform</a></strong>
  99
 100 <dd>
 101 <p>Add MM_Win32_VERSION.</p>
 102 </dd>
 103 </li>
 104 <dt><strong><a name="item_platform_constants">platform_constants</a></strong>
 105
 106 <dt><strong><a name="item_special_targets">special_targets</a></strong>
 107
 108 <dd>
 109 <p>Add .USESHELL target for dmake.</p>
 110 </dd>
 111 </li>
 112 <dt><strong><a name="item_static_lib">static_lib</a></strong>
 113
 114 <dd>
 115 <p>Changes how to run the linker.</p>
 116 </dd>
 117 <dd>
 118 <p>The rest is duplicate code from MM_Unix.  Should move the linker code
 119 to its own method.</p>
 120 </dd>
 121 </li>
 122 <dt><strong><a name="item_dynamic_lib">dynamic_lib</a></strong>
 123
 124 <dd>
 125 <p>Complicated stuff for Win32 that I don't understand. :(</p>
 126 </dd>
 127 </li>
 128 <dt><strong><a name="item_extra_clean_files">extra_clean_files</a></strong>
 129
 130 <dd>
 131 <p>Clean out some extra dll.{base,exp} files which might be generated by
 132 gcc.  Otherwise, take out all *.pdb files.</p>
 133 </dd>
 134 </li>
 135 <dt><strong><a name="item_init_linker">init_linker</a></strong>
 136
 137 <dt><strong><a name="item_perl_script">perl_script</a></strong>
 138
 139 <dd>
 140 <p>Checks for the perl program under several common perl extensions.</p>
 141 </dd>
 142 </li>
 143 <dt><strong><a name="item_xs_o">xs_o</a></strong>
 144
 145 <dd>
 146 <p>This target is stubbed out.  Not sure why.</p>
 147 </dd>
 148 </li>
 149 <dt><strong><a name="item_pasthru">pasthru</a></strong>
 150
 151 <dd>
 152 <p>All we send is -nologo to nmake to prevent it from printing its damned
 153 banner.</p>
 154 </dd>
 155 </li>
 156 <dt><strong><a name="item_oneliner">oneliner</a></strong>
 157
 158 <dd>
 159 <p>These are based on what command.com does on Win98.  They may be wrong
 160 for other Windows shells, I don't know.</p>
 161 </dd>
 162 </li>
 163 <dt><strong><a name="item_cd">cd</a></strong>
 164
 165 <dd>
 166 <p>dmake can handle Unix style cd'ing but nmake (at least 1.5) cannot.  It
 167 wants:</p>
 168 </dd>
 169 <dd>
 170 <pre>
 171     cd dir
 172     command
 173     another_command
 174     cd ..</pre>
 175 </dd>
 176 <dd>
 177 <p><strong>NOTE</strong> This cd can only go one level down.  So far this sufficient for
 178 what MakeMaker needs.</p>
 179 </dd>
 180 </li>
 181 <dt><strong><a name="item_max_exec_len">max_exec_len</a></strong>
 182
 183 <dd>
 184 <p>nmake 1.50 limits command length to 2048 characters.</p>
 185 </dd>
 186 </li>
 187 <dt><strong><a name="item_os_flavor">os_flavor</a></strong>
 188
 189 <dd>
 190 <p>Windows is Win32.</p>
 191 </dd>
 192 </li>
 193 </dl>
 194 <table border="0" width="100%" cellspacing="0" cellpadding="3">
 195 <tr><td class="block" style="background-color: #cccccc" valign="middle">
 196 <big><strong><span class="block">&nbsp;ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker</span></strong></big>
 197 </td></tr>
 198 </table>
 199
 200 </body>
 201
 202 </html>