[perl5.git] / README.riscos

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

README.riscos - Perl version 5 for RISC OS

=head1 DESCRIPTION

This document gives instructions for building Perl for RISC OS. It is
complicated by the need to cross compile. There is a binary version of
perl available from L<http://www.cp15.org/perl/> which you may wish to
use instead of trying to compile it yourself.

=head1 BUILD

You need an installed and working gccsdk cross compiler
L<http://gccsdk.riscos.info/> and REXEN
L<http://www.cp15.org/programming/>

Firstly, copy the source and build a native copy of perl for your host
system.
Then, in the source to be cross compiled:

=over 4

=item

    $ ./Configure

=item

Select the riscos hint file. The default answers for the rest of the
questions are usually sufficient.

Note that, if you wish to run Configure non-interactively (see the INSTALL
document for details), to have it select the correct hint file, you'll
need to provide the argument -Dhintfile=riscos on the Configure
command-line.

=item

    $ make miniperl

=item

This should build miniperl and then fail when it tries to run it.

=item

Copy the miniperl executable from the native build done earlier to
replace the cross compiled miniperl.

=item

    $ make

=item

This will use miniperl to complete the rest of the build.

=back

=head1 AUTHOR

Alex Waugh <alex@alexwaugh.com>
Commit	Line	Data
7ee146b1 AW	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	README.riscos - Perl version 5 for RISC OS
	8
	9	=head1 DESCRIPTION
	10
b5c148cc	11	This document gives instructions for building Perl for RISC OS. It is
7ee146b1 AW	12	complicated by the need to cross compile. There is a binary version of
	13	perl available from L<http://www.cp15.org/perl/> which you may wish to
	14	use instead of trying to compile it yourself.
	15
	16	=head1 BUILD
	17
	18	You need an installed and working gccsdk cross compiler
	19	L<http://gccsdk.riscos.info/> and REXEN
	20	L<http://www.cp15.org/programming/>
	21
	22	Firstly, copy the source and build a native copy of perl for your host
	23	system.
	24	Then, in the source to be cross compiled:
	25
	26	=over 4
	27
	28	=item
	29
	30	$ ./Configure
	31
	32	=item
	33
	34	Select the riscos hint file. The default answers for the rest of the
	35	questions are usually sufficient.
	36
b5c148cc RGS	37	Note that, if you wish to run Configure non-interactively (see the INSTALL
	38	document for details), to have it select the correct hint file, you'll
	39	need to provide the argument -Dhintfile=riscos on the Configure
	40	command-line.
	41
7ee146b1 AW	42	=item
	43
	44	$ make miniperl
	45
	46	=item
	47
	48	This should build miniperl and then fail when it tries to run it.
	49
	50	=item
	51
	52	Copy the miniperl executable from the native build done earlier to
	53	replace the cross compiled miniperl.
	54
	55	=item
	56
	57	$ make
	58
	59	=item
	60
	61	This will use miniperl to complete the rest of the build.
	62
	63	=back
	64
	65	=head1 AUTHOR
	66
	67	Alex Waugh <alex@alexwaugh.com>