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