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 README.riscos - Perl version 5 for RISC OS
   8
   9 =head1 DESCRIPTION
  10
  11 This document give 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
  29
  30     $ ./Configure
  31
  32 =item
  33
  34 Select the riscos hint file. The default answers for the rest of the
  35 questions are usually sufficient.
  36
  37 =item
  38
  39     $ make miniperl
  40
  41 =item
  42
  43 This should build miniperl and then fail when it tries to run it.
  44
  45 =item
  46
  47 Copy the miniperl executable from the native build done earlier to
  48 replace the cross compiled miniperl.
  49
  50 =item
  51
  52     $ make
  53
  54 =item
  55
  56 This will use miniperl to complete the rest of the build.
  57
  58 =back
  59
  60 =head1 AUTHOR
  61
  62 Alex Waugh <alex@alexwaugh.com>
  63