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