README.ce

   1 If you read this file _as_is_, just ignore the funny characters you
   2 see.  It is written in the POD format (see pod/perlpod.pod) which is
   3 specifically designed to be readable as is.
   4
   5 =head1 Name
   6
   7 Perl for WinCE
   8
   9 =head1 Description
  10
  11 This file gives the instructions for building Perl5.8 and above for
  12 WinCE.  Please read and understand the terms under which this
  13 software is distributed.
  14
  15 =head1 Build
  16
  17 This section describes the steps to be performed to build PerlCE.
  18 You may find additional and newer information about building perl
  19 for WincE using following URL:
  20
  21   http://perlce.sourceforge.net
  22
  23 There should also be pre-built binaries there.
  24
  25 =head2 Tools & SDK
  26
  27 For compiling, you need following:
  28
  29 =over 4
  30
  31 =item * Microsoft Embedded Visual Tools
  32
  33 =item * Microsoft Visual C++
  34
  35 =item * Rainer Keuchel's celib-sources
  36
  37 =item * Rainer Keuchel's console-sources
  38
  39 =back
  40
  41 Needed source files can be downloaded via:
  42 www.rainer-keuchel.de/wince/dirlist.html
  43
  44 =head2 Make
  45
  46 Please pay attention that starting from 5.8.0 miniperl *is* built
  47 and it facilitates in further building process. This means that
  48 in addition to compiler installation for mobile device you also need
  49 to have Microsoft Visual C++ installed as well.
  50
  51 On the bright side, you do not need to edit any files from ./win32
  52 subdirectory. Normally you only need to edit ./wince/compile.bat
  53 to reflect your system and run it.
  54
  55 File ./wince/compile.bat is actually a wrapper to call
  56 nmake -f makefile.ce with appropriate parameters and it accepts extra
  57 parameters and forwards them to "nmake" command as additional
  58 arguments. You should pass target this way.
  59
  60 Currently default target build all required perls, also there exists
  61 target 'dist' that prepares distribution file set. Other targets
  62 are currently in development stage.
  63
  64 So, to prepare distribution you need to do following:
  65
  66 =over 4
  67
  68 =item * go to ./wince subdirectory
  69
  70 =item * edit file compile.bat
  71
  72 =item * run
  73   compile.bat
  74
  75 =item * run
  76   compile.bat dist
  77
  78 =back
  79
  80 Before you start, you need to build celib.dll and w32console.
  81 See instructions in these packages for building.
  82
  83 =head1 Acknowledgements
  84
  85 The port for Win32 was used as a reference.
  86
  87 =head1 AUTHORS
  88
  89 Rainer Keuchel (keuchel@netwave.de)
  90 Vadim Konovalov (vkonovalov@spb.lucent.com)
  91