README.riscos

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