Add a test for [perl #17753].
[p5sagit/p5-mst-13.2.git] / README.ce
CommitLineData
e1caacb4 1If you read this file _as_is_, just ignore the funny characters you
2see. It is written in the POD format (see pod/perlpod.pod) which is
3specifically designed to be readable as is.
4
5=head1 Name
6
7Perl for WinCE
8
9=head1 Description
10
2e64bfdb 11This file gives the instructions for building Perl5.8 and above for
e1caacb4 12WinCE. Please read and understand the terms under which this
13software is distributed.
14
15=head1 Build
16
17This section describes the steps to be performed to build PerlCE.
2e64bfdb 18You may find additional and newer information about building perl
19for WincE using following URL:
20
21 http://perlce.sourceforge.net
22
23There should also be pre-built binaries there.
e1caacb4 24
25=head2 Tools & SDK
26
2e64bfdb 27For 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
41Needed source files can be downloaded via:
42www.rainer-keuchel.de/wince/dirlist.html
43
e1caacb4 44=head2 Make
45
2e64bfdb 46Please pay attention that starting from 5.8.0 miniperl *is* built
47and it facilitates in further building process. This means that
48in addition to compiler installation for mobile device you also need
49to have Microsoft Visual C++ installed as well.
e1caacb4 50
2e64bfdb 51On the bright side, you do not need to edit any files from ./win32
52subdirectory. Normally you only need to edit ./wince/compile.bat
53to reflect your system and run it.
e1caacb4 54
2e64bfdb 55File ./wince/compile.bat is actually a wrapper to call
56nmake -f makefile.ce with appropriate parameters and it accepts extra
57parameters and forwards them to "nmake" command as additional
58arguments. You should pass target this way.
e1caacb4 59
2e64bfdb 60Currently default target build all required perls, also there exists
61target 'dist' that prepares distribution file set. Other targets
62are currently in development stage.
63
64So, 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
80Before you start, you need to build celib.dll and w32console.
81See instructions in these packages for building.
e1caacb4 82
83=head1 Acknowledgements
84
85The port for Win32 was used as a reference.
86
2e64bfdb 87=head1 AUTHORS
e1caacb4 88
89Rainer Keuchel (keuchel@netwave.de)
2e64bfdb 90Vadim Konovalov (vkonovalov@spb.lucent.com)
91