mingw/html/pod/perlce.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>perlce - Perl for WinCE</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;perlce - Perl for WinCE</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="#description">DESCRIPTION</a></li>
  24         <li><a href="#build">BUILD</a></li>
  25         <ul>
  26
  27                 <li><a href="#tools___sdk">Tools &amp; SDK</a></li>
  28                 <li><a href="#make">Make</a></li>
  29         </ul>
  30
  31         <li><a href="#acknowledgements">ACKNOWLEDGEMENTS</a></li>
  32         <li><a href="#authors">AUTHORS</a></li>
  33 </ul>
  34 <!-- INDEX END -->
  35
  36 <hr />
  37 <p>
  38 </p>
  39 <h1><a name="name">NAME</a></h1>
  40 <p>perlce - Perl for WinCE</p>
  41 <p>
  42 </p>
  43 <hr />
  44 <h1><a name="description">DESCRIPTION</a></h1>
  45 <p>This file gives the instructions for building Perl5.8 and above for
  46 WinCE.  Please read and understand the terms under which this
  47 software is distributed.</p>
  48 <p>
  49 </p>
  50 <hr />
  51 <h1><a name="build">BUILD</a></h1>
  52 <p>This section describes the steps to be performed to build PerlCE.
  53 You may find additional and newer information about building perl
  54 for WinCE using following URL:</p>
  55 <pre>
  56   <a href="http://">http://</a><a href="//C|\msysgit\mingw\html/pod/perlce.html">perlce</a>.sourceforge.net</pre>
  57 <p>There should also be pre-built binaries there.</p>
  58 <p>Don't be confused by large size of downloaded distribution or constructed
  59 binaries: entire distribution could be large for WinCE ideology, but
  60 you may strip it at your wish and use only required parts.</p>
  61 <p>
  62 </p>
  63 <h2><a name="tools___sdk">Tools &amp; SDK</a></h2>
  64 <p>For compiling, you need following:</p>
  65 <ul>
  66 <li><strong><a name="item_microsoft_embedded_visual_tools">Microsoft Embedded Visual Tools</a></strong>
  67
  68 <li><strong><a name="item_microsoft_visual_c_2b_2b">Microsoft Visual C++</a></strong>
  69
  70 <li><strong><a name="item_rainer_keuchel_27s_celib_2dsources">Rainer Keuchel's celib-sources</a></strong>
  71
  72 <li><strong><a name="item_rainer_keuchel_27s_console_2dsources">Rainer Keuchel's console-sources</a></strong>
  73
  74 </ul>
  75 <p>Needed source files can be downloaded via:
  76 www.rainer-keuchel.de/wince/dirlist.html</p>
  77 <p>
  78 </p>
  79 <h2><a name="make">Make</a></h2>
  80 <p>Please pay attention that starting from 5.8.0 miniperl *is* built
  81 and it facilitates in further building process. This means that
  82 in addition to compiler installation for mobile device you also need
  83 to have Microsoft Visual C++ installed as well.</p>
  84 <p>On the bright side, you do not need to edit any files from ./win32
  85 subdirectory. Normally you only need to edit ./wince/compile.bat
  86 to reflect your system and run it.</p>
  87 <p>File ./wince/compile.bat is actually a wrapper to call
  88 nmake -f makefile.ce with appropriate parameters and it accepts extra
  89 parameters and forwards them to ``nmake'' command as additional
  90 arguments. You should pass target this way.</p>
  91 <p>To prepare distribution you need to do following:</p>
  92 <ul>
  93 <li><strong><a name="item_go_to__2e_2fwince_subdirectory">go to ./wince subdirectory</a></strong>
  94
  95 <li><strong><a name="item_edit_file_compile_2ebat">edit file compile.bat</a></strong>
  96
  97 <li><strong><a name="item_run_compile_2ebat">run
  98   compile.bat</a></strong>
  99
 100 <li><strong><a name="item_run_compile_2ebat_dist">run
 101   compile.bat dist</a></strong>
 102
 103 </ul>
 104 <p>makefile.ce has CROSS_NAME macro, and it is used further to refer to
 105 your cross-compilation scheme. You could assign a name to it, but this
 106 is not necessary, because by default it is assigned after your machine
 107 configuration name, such as ``wince-sh3-hpc-wce211'', and this is enough
 108 to distinguish different builds at the same time. This option could be
 109 handy for several different builds on same platform to perform, say,
 110 threaded build. In a following example we assume that all required
 111 environment variables are set properly for C cross-compiler (a special
 112 *.bat file could fit perfectly to this purpose) and your compile.bat
 113 has proper ``MACHINE'' parameter set, to, say, ``wince-mips-pocket-wce300''.</p>
 114 <pre>
 115   compile.bat
 116   compile.bat dist
 117   compile.bat CROSS_NAME=mips-wce300-thr &quot;USE_ITHREADS=define&quot; &quot;USE_IMP_SYS=define&quot; &quot;USE_MULTI=define&quot;
 118   compile.bat CROSS_NAME=mips-wce300-thr &quot;USE_ITHREADS=define&quot; &quot;USE_IMP_SYS=define&quot; &quot;USE_MULTI=define&quot; dist</pre>
 119 <p>If all goes okay and no errors during a build, you'll get two independent
 120 distributions: ``wince-mips-pocket-wce300'' and ``mips-wce300-thr''.</p>
 121 <p>Target 'dist' prepares distribution file set. Target 'zipdist' performs
 122 same as 'dist' but additionally compresses distribution files into zip
 123 archive.</p>
 124 <p>NOTE: during a build there could be created a number (or one) of Config.pm
 125 for cross-compilation (``foreign'' Config.pm) and those are hidden inside
 126 ../xlib/$(CROSS_NAME) with other auxilary files, but, and this is important to
 127 note, there should be *no* Config.pm for host miniperl.
 128 If you'll get an error that perl could not find Config.pm somewhere in building
 129 process this means something went wrong. Most probably you forgot to
 130 specify a cross-compilation when invoking miniperl.exe to Makefile.PL
 131 When building an extension for cross-compilation your command line should
 132 look like</p>
 133 <pre>
 134   ..\miniperl.exe -I..\lib -MCross=mips-wce300-thr Makefile.PL</pre>
 135 <p>or just</p>
 136 <pre>
 137   ..\miniperl.exe -I..\lib -MCross Makefile.PL</pre>
 138 <p>to refer a cross-compilation that was created last time.</p>
 139 <p>If you decided to build with fcrypt.c file, please refer to README.win32
 140 file, as long as all legal considerations and steps to do are exactly same
 141 in this case.</p>
 142 <p>All questions related to building for WinCE devices could be asked in
 143 <a href="mailto:perlce-users@lists.sourceforge.net">perlce-users@lists.sourceforge.net</a> mailing list.</p>
 144 <p>
 145 </p>
 146 <hr />
 147 <h1><a name="acknowledgements">ACKNOWLEDGEMENTS</a></h1>
 148 <p>The port for Win32 was used as a reference.</p>
 149 <p>
 150 </p>
 151 <hr />
 152 <h1><a name="authors">AUTHORS</a></h1>
 153 <p>Rainer Keuchel (<a href="mailto:keuchel@netwave.de">keuchel@netwave.de</a>)
 154 Vadim Konovalov (<a href="mailto:vkonovalov@spb.lucent.com">vkonovalov@spb.lucent.com</a>)</p>
 155 <table border="0" width="100%" cellspacing="0" cellpadding="3">
 156 <tr><td class="block" style="background-color: #cccccc" valign="middle">
 157 <big><strong><span class="block">&nbsp;perlce - Perl for WinCE</span></strong></big>
 158 </td></tr>
 159 </table>
 160
 161 </body>
 162
 163 </html>