X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.ce;h=23378a98dd0c70ae36420d35dc0bc71b9e63d139;hb=6ae23f4134087bc885284bd6ae11bfeb719e2459;hp=a216f33da19a6527c87649e74ff428f42c29b90c;hpb=e1caacb4fdb62cb28dc825ca0115faf95e569339;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.ce b/README.ce index a216f33..23378a9 100644 --- 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) +