Incorporate a large list of corrections and updates to module versions
[perl.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 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
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 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
43
44     $ make miniperl
45
46 =item
47
48 This should build miniperl and then fail when it tries to run it.
49
50 =item
51
52 Copy the miniperl executable from the native build done earlier to
53 replace the cross compiled miniperl.
54
55 =item
56
57     $ make
58
59 =item
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>