=head1 NAME
-README.riscos - Perl version 5 for RISC OS
+perlriscos - Perl version 5 for RISC OS
=head1 DESCRIPTION
-This document give instructions for building Perl for RISC OS. It is
+This document gives instructions for building Perl for RISC OS. It is
complicated by the need to cross compile. There is a binary version of
perl available from L<http://www.cp15.org/perl/> which you may wish to
use instead of trying to compile it yourself.
=over 4
-=item
+=item 1.
$ ./Configure
-=item
+=item 2.
Select the riscos hint file. The default answers for the rest of the
questions are usually sufficient.
-=item
+Note that, if you wish to run Configure non-interactively (see the INSTALL
+document for details), to have it select the correct hint file, you'll
+need to provide the argument -Dhintfile=riscos on the Configure
+command-line.
+
+=item 3.
$ make miniperl
-=item
+=item 4.
This should build miniperl and then fail when it tries to run it.
-=item
+=item 5.
Copy the miniperl executable from the native build done earlier to
replace the cross compiled miniperl.
-=item
+=item 6.
$ make
-=item
+=item 7.
This will use miniperl to complete the rest of the build.
=head1 AUTHOR
Alex Waugh <alex@alexwaugh.com>
-