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