Upgrade to Tie::File 0.95.
[p5sagit/p5-mst-13.2.git] / README.ce
index a216f33..23378a9 100644 (file)
--- a/README.ce
+++ b/README.ce
@@ -8,52 +8,84 @@ Perl for WinCE
 
 =head1 Description
 
-This file gives the instructions for building Perl5.6 and above for
+This file gives the instructions for building Perl5.8 and above for
 WinCE.  Please read and understand the terms under which this
 software is distributed.
 
 =head1 Build
 
 This section describes the steps to be performed to build PerlCE.
+You may find additional and newer information about building perl
+for WincE using following URL:
+
+  http://perlce.sourceforge.net
+
+There should also be pre-built binaries there.
 
 =head2 Tools & SDK
 
-For compiling, you need Microsoft Embedded Visual Tools, my
-celib-sources, my console-sources and a perl for win32.
+For compiling, you need following:
+
+=over 4
+
+=item * Microsoft Embedded Visual Tools
+
+=item * Microsoft Visual C++
+
+=item * Rainer Keuchel's celib-sources
+
+=item * Rainer Keuchel's console-sources
+
+=back
 
 Needed source files can be downloaded via:
 www.rainer-keuchel.de/wince/dirlist.html
 
-Some portions of the makefile need a shell for win32, rm, cp, mv,
-xmkdir (mkdir with a -p option).  It also uses my cecopy program for
-copying files to the ce device.
-
 =head2 Make
 
-Miniperl is not built. A pre-existent win32 perl is used.
+Please pay attention that starting from 5.8.0 miniperl *is* built
+and it facilitates in further building process. This means that
+in addition to compiler installation for mobile device you also need
+to have Microsoft Visual C++ installed as well.
 
-The paths for tools and additional libraries have to be changed in
-wince/makefile.ce.
+On the bright side, you do not need to edit any files from ./win32
+subdirectory. Normally you only need to edit ./wince/compile.bat
+to reflect your system and run it.
 
-Different ce targets can be specified with the TARGET macro.
+File ./wince/compile.bat is actually a wrapper to call
+nmake -f makefile.ce with appropriate parameters and it accepts extra
+parameters and forwards them to "nmake" command as additional
+arguments. You should pass target this way.
 
-Before you start, you need to build celib.dll and w32console.
-See instructions in these packages for building.
+Currently default target build all required perls, also there exists
+target 'dist' that prepares distribution file set. Other targets
+are currently in development stage.
+
+So, to prepare distribution you need to do following:
+
+=over 4
+
+=item * go to ./wince subdirectory
+
+=item * edit file compile.bat
 
-In the wince directory, type "nmake -f makefile.ce". This should
-build perl.exe and and perl.dll. For building extension dlls,
-type "nmake -f makefile.ce dlls"
+=item * run 
+  compile.bat
 
-When building ext dlls, you get lots of macro redefinition
-errors. Just ignore them.
+=item * run 
+  compile.bat dist
 
-For further information, look in the text files in the wince
-sub-directory.
+=back
+
+Before you start, you need to build celib.dll and w32console.
+See instructions in these packages for building.
 
 =head1 Acknowledgements
 
 The port for Win32 was used as a reference.
 
-=head1 Author
+=head1 AUTHORS
 
 Rainer Keuchel (keuchel@netwave.de)
+Vadim Konovalov (vkonovalov@spb.lucent.com)
+