https://perl5.git.perl.org / perl5.git / blame
| 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 | ||
| 11 | This document give 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 | |
| 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 | ||
| 37 | =item | |
| 38 | ||
| 39 | $ make miniperl | |
| 40 | ||
| 41 | =item | |
| 42 | ||
| 43 | This should build miniperl and then fail when it tries to run it. | |
| 44 | ||
| 45 | =item | |
| 46 | ||
| 47 | Copy the miniperl executable from the native build done earlier to | |
| 48 | replace the cross compiled miniperl. | |
| 49 | ||
| 50 | =item | |
| 51 | ||
| 52 | $ make | |
| 53 | ||
| 54 | =item | |
| 55 | ||
| 56 | This will use miniperl to complete the rest of the build. | |
| 57 | ||
| 58 | =back | |
| 59 | ||
| 60 | =head1 AUTHOR | |
| 61 | ||
| 62 | Alex Waugh <alex@alexwaugh.com> | |
| 63 |