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