[Summary view] [Print] [Text view]

   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 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
  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  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
  43  
  44      $ make miniperl
  45  
  46  =item
  47  
  48  This should build miniperl and then fail when it tries to run it.
  49  
  50  =item
  51  
  52  Copy the miniperl executable from the native build done earlier to
  53  replace the cross compiled miniperl.
  54  
  55  =item
  56  
  57      $ make
  58  
  59  =item
  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>