This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Integrate mainline
[perl5.git] / README.amiga
index 4a04dad..709fcc8 100644 (file)
@@ -18,7 +18,7 @@ be read I<as is>: either as F<README.amiga>, or F<pod/perlamiga.pod>.
 
 A recent version of perl for the Amiga can be found at the Geek Gadgets
 section of the Aminet:
-  
+
       http://www.aminet.net/~aminet/dirs/dev_gg.html
 
 =cut
@@ -40,7 +40,7 @@ Contents
          -  GNU info files 
          -  LaTeX docs 
        BUILD 
-         -  Prerequisites 
+         -  Build Prerequisites 
          -  Getting the perl source 
          -  Application of the patches 
          -  Making 
@@ -51,7 +51,7 @@ Contents
 
 =head1 DESCRIPTION
 
-=head2 Prerequisites
+=head2 Prerequisites for Compiling Perl on AmigaOS
 
 =over 6
 
@@ -103,14 +103,22 @@ deficiencies in the UNIX-emulation, most notably:
 
 =over 6
 
-=item fork()
+=item *
 
-=item some features of the UNIX filesystem regarding link count and file dates
+fork()
 
-=item inplace operation (the -i switch) without backup file
+=item 
 
-=item umask() works, but the correct permissions are only set when the file is
-      finally close()d
+some features of the UNIX filesystem regarding link count and file dates
+
+=item *
+
+inplace operation (the -i switch) without backup file
+
+=item *
+
+umask() works, but the correct permissions are only set when the file is
+finally close()d
 
 =back
 
@@ -131,7 +139,7 @@ For installation of the Unix emulation, read the appropriate docs.
 
 =head1 Accessing documentation
 
-=head2 Manpages
+=head2 Manpages for Perl on AmigaOS
 
 If you have C<man> installed on your system, and you installed perl
 manpages, use something like this:
@@ -153,7 +161,7 @@ for packages, and as usual, sometimes you need to give the section - C<3>
 above - to avoid shadowing by the I<less(1) manpage>.
 
 
-=head2 B<HTML>
+=head2 Perl HTML Documentation on AmigaOS
 
 If you have some WWW browser available, you can build B<HTML> docs.
 Cd to directory with F<.pod> files, and do like this
@@ -166,26 +174,26 @@ directory, and go ahead with reading docs.
 
 Alternatively you may be able to get these docs prebuilt from C<CPAN>.
 
-=head2 B<GNU> C<info> files
+=head2 Perl GNU Info Files on AmigaOS
 
 Users of C<Emacs> would appreciate it very much, especially with
 C<CPerl> mode loaded. You need to get latest C<pod2info> from C<CPAN>,
 or, alternately, prebuilt info pages.
 
-=head2 C<LaTeX> docs
+=head2 Perl LaTeX Documentation on AmigaOS
 
-can be constructed using C<pod2latex>.
+Can be constructed using C<pod2latex>.
 
-=head1 BUILD
+=head1 BUILDING PERL ON AMIGAOS
 
 Here we discuss how to build Perl under AmigaOS.
 
-=head2 Prerequisites
+=head2 Build Prerequisites for Perl on AmigaOS
 
 You need to have the latest B<ixemul> (Unix emulation for Amiga)
 from Aminet.
 
-=head2 Getting the perl source
+=head2 Getting the Perl Source for AmigaOS
 
 You can either get the latest perl-for-amiga source from Ninemoons
 and extract it with:
@@ -204,51 +212,21 @@ You will see a message about errors while extracting F<Configure>. This
 is normal and expected. (There is a conflict with a similarly-named file
 F<configure>, but it causes no harm.)
 
-=head2 Making
-       
-=over 4
-
-=item *
+=head2 Making Perl on AmigaOS
 
-remember to use a healthy sized stack (I used 2000000)
+Remember to use a hefty wad of stack (I use 2000000)
 
-=item *
+  sh configure.gnu --prefix=/gg
 
-your PATH environment variable must include /bin (e.g. ".:/bin" is good)
-(or, more precisely, it must include the directory where you have your
-basic UNIX utilities like test, cat, sed, and so on)
+Now type
 
-=item *
-       
-  sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
-
-=item *
-
-now type make depend
-
-       when the make depend has ended load the gnumakefile into a editor and
-       go to the end of the file
-       move upwards in the file until you reach av.o: EXTERN.h
-       and delete all lines down to # WARNING: Put....
-
-=item *
-
-now go to the x2p directory
-
-       load the gnumakefile
-       go to the end moveup until you reach hash.o: EXTERN.h
-       and delete all lines dowonwards until you reach
-       # WARNING: Put nothing....
-
-=item *
+  make depend
 
 Now!
 
   make
 
-=back
-
-=head2 Testing
+=head2 Testing Perl on AmigaOS
 
 Now run
 
@@ -259,7 +237,7 @@ Some tests will be skipped because they need the fork() function:
 F<io/pipe.t>, F<op/fork.t>, F<lib/filehand.t>, F<lib/open2.t>, F<lib/open3.t>, 
 F<lib/io_pipe.t>, F<lib/io_sock.t>
 
-=head2 Installing the built perl
+=head2 Installing the built Perl on AmigaOS
 
 Run