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