This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
perl5337delta: note that stadtx was removed
[perl5.git] / README.riscos
... / ...
CommitLineData
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
7perlriscos - Perl version 5 for RISC OS
8
9=head1 DESCRIPTION
10
11This document gives instructions for building Perl for RISC OS. It is
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 1.
29
30 $ ./Configure
31
32=item 2.
33
34Select the riscos hint file. The default answers for the rest of the
35questions are usually sufficient.
36
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
42=item 3.
43
44 $ make miniperl
45
46=item 4.
47
48This should build miniperl and then fail when it tries to run it.
49
50=item 5.
51
52Copy the miniperl executable from the native build done earlier to
53replace the cross compiled miniperl.
54
55=item 6.
56
57 $ make
58
59=item 7.
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>