summaryrefslogtreecommitdiff
path: root/README.riscos
diff options
context:
space:
mode:
authorAlex Waugh <alex@alexwaugh.com>2006-04-17 01:14:26 +0100
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2006-04-18 12:48:31 +0000
commit7ee146b12403586cf7249a676b2be9b7658f67fd (patch)
tree1b79a89c55197bf11d0879b5cceab0caa61a53a5 /README.riscos
parent4154741246a440c7ccc4e633e6d115949af4ee56 (diff)
downloadperl-7ee146b12403586cf7249a676b2be9b7658f67fd.tar.gz
Support compiling for RISC OS
Message-ID: <2498b2184e.ajw498@caramel.cp15.org> p4raw-id: //depot/perl@27884
Diffstat (limited to 'README.riscos')
-rw-r--r--README.riscos63
1 files changed, 63 insertions, 0 deletions
diff --git a/README.riscos b/README.riscos
new file mode 100644
index 0000000000..61202fe5a2
--- /dev/null
+++ b/README.riscos
@@ -0,0 +1,63 @@
+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
+
+README.riscos - Perl version 5 for RISC OS
+
+=head1 DESCRIPTION
+
+This document give 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<http://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 gccsdk cross compiler
+L<http://gccsdk.riscos.info/> and REXEN
+L<http://www.cp15.org/programming/>
+
+Firstly, 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
+
+ $ ./Configure
+
+=item
+
+Select the riscos hint file. The default answers for the rest of the
+questions are usually sufficient.
+
+=item
+
+ $ make miniperl
+
+=item
+
+This should build miniperl and then fail when it tries to run it.
+
+=item
+
+Copy the miniperl executable from the native build done earlier to
+replace the cross compiled miniperl.
+
+=item
+
+ $ make
+
+=item
+
+This will use miniperl to complete the rest of the build.
+
+=back
+
+=head1 AUTHOR
+
+Alex Waugh <alex@alexwaugh.com>
+