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