[p5sagit/p5-mst-13.2.git] / README.ce

If you read this file _as_is_, just ignore the funny characters you
see.  It is written in the POD format (see pod/perlpod.pod) which is
specifically designed to be readable as is.

=head1 Name

Perl for WinCE

=head1 Description

This file gives the instructions for building Perl5.6 and above for
WinCE.  Please read and understand the terms under which this
software is distributed.

=head1 Build

This section describes the steps to be performed to build PerlCE.

=head2 Tools & SDK

For compiling, you need Microsoft Embedded Visual Tools, my
celib-sources, my console-sources and a perl for win32.

Needed source files can be downloaded via:
www.rainer-keuchel.de/wince/dirlist.html

Some portions of the makefile need a shell for win32, rm, cp, mv,
xmkdir (mkdir with a -p option).  It also uses my cecopy program for
copying files to the ce device.

=head2 Make

Miniperl is not built. A pre-existent win32 perl is used.

The paths for tools and additional libraries have to be changed in
wince/makefile.ce.

Different ce targets can be specified with the TARGET macro.

Before you start, you need to build celib.dll and w32console.
See instructions in these packages for building.

In the wince directory, type "nmake -f makefile.ce". This should
build perl.exe and perl.dll. For building extension dlls,
type "nmake -f makefile.ce dlls"

When building ext dlls, you get lots of macro redefinition
errors. Just ignore them.

For further information, look in the text files in the wince
sub-directory.

=head1 Acknowledgements

The port for Win32 was used as a reference.

=head1 Author

Rainer Keuchel (keuchel@netwave.de)
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
	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
d1be9408	44	build perl.exe and perl.dll. For building extension dlls,
e1caacb4	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)