| 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.6 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 | |
| 19 | =head2 Tools & SDK |
| 20 | |
| 21 | For compiling, you need Microsoft Embedded Visual Tools, my |
| 22 | celib-sources, my console-sources and a perl for win32. |
| 23 | |
| 24 | Needed source files can be downloaded via: |
| 25 | www.rainer-keuchel.de/wince/dirlist.html |
| 26 | |
| 27 | Some portions of the makefile need a shell for win32, rm, cp, mv, |
| 28 | xmkdir (mkdir with a -p option). It also uses my cecopy program for |
| 29 | copying files to the ce device. |
| 30 | |
| 31 | =head2 Make |
| 32 | |
| 33 | Miniperl is not built. A pre-existent win32 perl is used. |
| 34 | |
| 35 | The paths for tools and additional libraries have to be changed in |
| 36 | wince/makefile.ce. |
| 37 | |
| 38 | Different ce targets can be specified with the TARGET macro. |
| 39 | |
| 40 | Before you start, you need to build celib.dll and w32console. |
| 41 | See instructions in these packages for building. |
| 42 | |
| 43 | In the wince directory, type "nmake -f makefile.ce". This should |
| 44 | build perl.exe and perl.dll. For building extension dlls, |
| 45 | type "nmake -f makefile.ce dlls" |
| 46 | |
| 47 | When building ext dlls, you get lots of macro redefinition |
| 48 | errors. Just ignore them. |
| 49 | |
| 50 | For further information, look in the text files in the wince |
| 51 | sub-directory. |
| 52 | |
| 53 | =head1 Acknowledgements |
| 54 | |
| 55 | The port for Win32 was used as a reference. |
| 56 | |
| 57 | =head1 Author |
| 58 | |
| 59 | Rainer Keuchel (keuchel@netwave.de) |