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