This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Support compiling for RISC OS
[perl5.git] / README.riscos
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