Commit | Line | Data |
7ee146b1 |
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 | |