| 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 | |
| 11 | This document gives instructions for building Perl for RISC OS. It is |
| 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 1. |
| 29 | |
| 30 | $ ./Configure |
| 31 | |
| 32 | =item 2. |
| 33 | |
| 34 | Select the riscos hint file. The default answers for the rest of the |
| 35 | questions are usually sufficient. |
| 36 | |
| 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 | |
| 42 | =item 3. |
| 43 | |
| 44 | $ make miniperl |
| 45 | |
| 46 | =item 4. |
| 47 | |
| 48 | This should build miniperl and then fail when it tries to run it. |
| 49 | |
| 50 | =item 5. |
| 51 | |
| 52 | Copy the miniperl executable from the native build done earlier to |
| 53 | replace the cross compiled miniperl. |
| 54 | |
| 55 | =item 6. |
| 56 | |
| 57 | $ make |
| 58 | |
| 59 | =item 7. |
| 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> |