This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
EBCDIC: special cases of special cases.
[perl5.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.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)