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>