This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Temporarily uncuddle the 'else's
[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
de2902a6 7perlriscos - Perl version 5 for RISC OS
7ee146b1
AW
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
f094a618 28=item 1.
7ee146b1
AW
29
30 $ ./Configure
31
f094a618 32=item 2.
7ee146b1
AW
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
f094a618 42=item 3.
7ee146b1
AW
43
44 $ make miniperl
45
f094a618 46=item 4.
7ee146b1
AW
47
48This should build miniperl and then fail when it tries to run it.
49
f094a618 50=item 5.
7ee146b1
AW
51
52Copy the miniperl executable from the native build done earlier to
53replace the cross compiled miniperl.
54
f094a618 55=item 6.
7ee146b1
AW
56
57 $ make
58
f094a618 59=item 7.
7ee146b1
AW
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>