https://perl5.git.perl.org / perl5.git / blame
| Commit | Line | Data |
|---|---|---|
| e1caacb4 JH |
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 | ||
| 2e64bfdb | 11 | This file gives the instructions for building Perl5.8 and above for |
| e1caacb4 JH |
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. | |
| 2e64bfdb JH |
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. | |
| e1caacb4 JH |
24 | |
| 25 | =head2 Tools & SDK | |
| 26 | ||
| 2e64bfdb JH |
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 | |
| e1caacb4 JH |
40 | |
| 41 | Needed source files can be downloaded via: | |
| 42 | www.rainer-keuchel.de/wince/dirlist.html | |
| 43 | ||
| e1caacb4 JH |
44 | =head2 Make |
| 45 | ||
| 2e64bfdb JH |
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. | |
| e1caacb4 | 50 | |
| 2e64bfdb JH |
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. | |
| e1caacb4 | 54 | |
| 2e64bfdb JH |
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. | |
| e1caacb4 | 59 | |
| 2e64bfdb JH |
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 | |
| e1caacb4 | 71 | |
| 2e64bfdb JH |
72 | =item * run |
| 73 | compile.bat | |
| e1caacb4 | 74 | |
| 2e64bfdb JH |
75 | =item * run |
| 76 | compile.bat dist | |
| e1caacb4 | 77 | |
| 2e64bfdb JH |
78 | =back |
| 79 | ||
| 80 | Before you start, you need to build celib.dll and w32console. | |
| 81 | See instructions in these packages for building. | |
| e1caacb4 JH |
82 | |
| 83 | =head1 Acknowledgements | |
| 84 | ||
| 85 | The port for Win32 was used as a reference. | |
| 86 | ||
| 2e64bfdb | 87 | =head1 AUTHORS |
| e1caacb4 JH |
88 | |
| 89 | Rainer Keuchel (keuchel@netwave.de) | |
| 2e64bfdb JH |
90 | Vadim Konovalov (vkonovalov@spb.lucent.com) |
| 91 |