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

Summary
-------

This is a patch set which adds cross-compilation to the perl
buildsystem.  It was built as a part of the Open Zaurus
(http://www.openzaurus.com/) distribution.  Most / All of the
arm compiler optimisations are "borrowed" from this excellent
project.

The main target is arm-linux but I have also managed to
successfully cross-compile perl for solaris x86 using the same
buildsystem.

We are currently dependent on an existing working local copy of
perl ** of the same version and revision ** which is available
as /usr/bin/perl.  This could be migrated to using native
miniperl with some additional effort.

Obviously you need a working and tested cross-compiler for your
build and target combination.  The binary directory must be in
your path.

1)	You should be reading me (README) in perl-5.x.x/Cross

2)	Make sure you are in the Cross directory.

3)	Edit the file 'config' to contain your target platform information.

4)	make patch	## This will patch the existing source-tree.
5)	make perl	## Will make perl

The Obvious Ommissions
----------------------

This does NOT perform any installation as site installation method will
be dependant on the target arch and OS. 

make test will NOT work as the binaries and libraries will not execute.

Due to space limitations on the Zaurus (it's a PDA) we do not provide
documentation in the core - Therefore man pages are not even generated.

	Note that the Cross/ directory is also used by a different
	cross-compilation setup described in the INSTALL file, and
	executed by Configure.  There should be no conflicts since
	it is unlikely both that cross-compilation setups are used
	simultaneously.

Enjoy!

References
----------
Redvers Davies <red@criticalintegration.com>
Open Zaurus http://www.openzaurus.org/
Perl OZ Packages http://www.openzaurus.org/official/testing/feed/
Commit	Line	Data
6a809565	1	Summary
6a809565	2	-------
58a21a9b	3
6a809565	4	This is a patch set which adds cross-compilation to the perl
	5	buildsystem. It was built as a part of the Open Zaurus
	6	(http://www.openzaurus.com/) distribution. Most / All of the
e42fa77b	7	arm compiler optimisations are "borrowed" from this excellent
e42fa77b	8	project.
6a809565	9
	10	The main target is arm-linux but I have also managed to
	11	successfully cross-compile perl for solaris x86 using the same
	12	buildsystem.
	13
	14	We are currently dependent on an existing working local copy of
e42fa77b	15	perl of the same version and revision which is available
	16	as /usr/bin/perl. This could be migrated to using native
	17	miniperl with some additional effort.
6a809565	18
	19	Obviously you need a working and tested cross-compiler for your
	20	build and target combination. The binary directory must be in
	21	your path.
	22
	23	1) You should be reading me (README) in perl-5.x.x/Cross
	24
	25	2) Make sure you are in the Cross directory.
	26
	27	3) Edit the file 'config' to contain your target platform information.
	28
	29	4) make patch ## This will patch the existing source-tree.
	30	5) make perl ## Will make perl
	31
	32	The Obvious Ommissions
	33	----------------------
	34
	35	This does NOT perform any installation as site installation method will
	36	be dependant on the target arch and OS.
	37
	38	make test will NOT work as the binaries and libraries will not execute.
	39
	40	Due to space limitations on the Zaurus (it's a PDA) we do not provide
	41	documentation in the core - Therefore man pages are not even generated.
	42
	43	Note that the Cross/ directory is also used by a different
	44	cross-compilation setup described in the INSTALL file, and
	45	executed by Configure. There should be no conflicts since
	46	it is unlikely both that cross-compilation setups are used
	47	simultaneously.
	48
	49	Enjoy!
	50
	51	References
e42fa77b	52	----------
6a809565	53	Redvers Davies <red@criticalintegration.com>
	54	Open Zaurus http://www.openzaurus.org/
	55	Perl OZ Packages http://www.openzaurus.org/official/testing/feed/