Add Anton Nikishaev to AUTHORS: RT #116959.
[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 perlriscos - 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 1.
29
30     $ ./Configure
31
32 =item 2.
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 3.
43
44     $ make miniperl
45
46 =item 4.
47
48 This should build miniperl and then fail when it tries to run it.
49
50 =item 5.
51
52 Copy the miniperl executable from the native build done earlier to
53 replace the cross compiled miniperl.
54
55 =item 6.
56
57     $ make
58
59 =item 7.
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>