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