68 lines
1.5 KiB
Plaintext
68 lines
1.5 KiB
Plaintext
|
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
|
||
|
|
||
|
perlriscos - 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 1.
|
||
|
|
||
|
$ ./Configure
|
||
|
|
||
|
=item 2.
|
||
|
|
||
|
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 3.
|
||
|
|
||
|
$ make miniperl
|
||
|
|
||
|
=item 4.
|
||
|
|
||
|
This should build miniperl and then fail when it tries to run it.
|
||
|
|
||
|
=item 5.
|
||
|
|
||
|
Copy the miniperl executable from the native build done earlier to
|
||
|
replace the cross compiled miniperl.
|
||
|
|
||
|
=item 6.
|
||
|
|
||
|
$ make
|
||
|
|
||
|
=item 7.
|
||
|
|
||
|
This will use miniperl to complete the rest of the build.
|
||
|
|
||
|
=back
|
||
|
|
||
|
=head1 AUTHOR
|
||
|
|
||
|
Alex Waugh <alex@alexwaugh.com>
|