Encode/IO doc tweaks.

[perl5.git] / README.amiga

diff --git a/README.amiga b/README.amiga
index 110f9cf..1a7c9d8 100644 (file)
--- a/README.amiga
+++ b/README.amiga
@@ -16,6 +16,11 @@ One can read this document in the following formats:
 to list some (not all may be available simultaneously), or it may
 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
 
 Contents
@@ -27,6 +32,7 @@ Contents
        DESCRIPTION 
          -  Prerequisites 
          -  Starting Perl programs under AmigaOS
+         -  Shortcomings of Perl under AmigaOS
        INSTALLATION 
        Accessing documentation 
          -  Manpages 
@@ -52,16 +58,12 @@ Contents
 =item B<Unix emulation for AmigaOS: ixemul.library>
 
 You need the Unix emulation for AmigaOS, whose most important part is
-B<ixemul.library>. For a minimum setup, get the following archives from
-ftp://ftp.ninemoons.com/pub/ade/current or a mirror:
-
-ixemul-45.1-bin.lha
-ixemul-45.1-env-bin.lha
-pdksh-4.9-bin.lha
-ADE-misc-bin.lha
+B<ixemul.library>. For a minimum setup, get the latest versions
+of the following packages from the Aminet archives (http://www.aminet.net/~aminet/):
 
-Note that there might be newer versions available by the time you read
-this.
+       ixemul-bin
+       ixemul-env-bin
+       pdksh-bin
 
 Note also that this is a minimum setup; you might want to add other
 packages of B<ADE> (the I<Amiga Developers Environment>).
@@ -94,16 +96,34 @@ of your scripts. Then you can invoke your scripts like under UNIX with
 necessary, F<perl> would be enough, but having full path would make it
 easier to use your script under *nix.)
 
+=head2 Shortcomings of Perl under AmigaOS
+
+Perl under AmigaOS lacks some features of perl under UNIX because of
+deficiencies in the UNIX-emulation, most notably:
+
+=over 6
+
+=item fork()
+
+=item 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
+
 =head1 INSTALLATION
 
 Change to the installation directory (most probably ADE:), and
 extract the binary distribution:
 
-lha -mraxe x perl-5.003-bin.lha
+lha -mraxe x perl-$VERSION-bin.lha
 
 or
 
-tar xvzpf perl-5.003-bin.tgz
+tar xvzpf perl-$VERSION-bin.tgz
 
 (Of course you need lha or tar and gunzip for this.)
 
@@ -162,16 +182,15 @@ Here we discuss how to build Perl under AmigaOS.
 
 =head2 Prerequisites
 
-You need to have the latest B<ADE> (Amiga Developers Environment)
-from ftp://ftp.ninemoons.com/pub/ade/current.
-Also, you need a lot of free memory, probably at least 8MB.
+You need to have the latest B<ixemul> (Unix emulation for Amiga)
+from Aminet.
 
 =head2 Getting the perl source
 
 You can either get the latest perl-for-amiga source from Ninemoons
 and extract it with:
 
-  tar xvzpf perl-5.004-src.tgz
+  tar xvzpf perl-$VERSION-src.tgz
 
 or get the official source from CPAN:
 
@@ -179,17 +198,28 @@ or get the official source from CPAN:
 
 Extract it like this
 
-  tar xvzpf perl5.004.tar.gz
+  tar xvzpf perl-$VERSION.tar.gz
 
 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
+       
+       remember to use a hefty wad of stack (I use 2000000)
+
+  sh configure.gnu --prefix=/gg
+
+       the makedepend script has to be edited if it fails
+       
+       change $cat to /bin/cat at line 75
+       change cat to /bin/cat at line 163
+       change cat to /bin/cat at line 176 (both)
+       change $cat to /bin/cat at line 190
 
-  sh configure.gnu --prefix=/ade
+       now type make depend
 
-Now
+Now!
 
   make
 
@@ -199,26 +229,10 @@ Now run
 
   make test
 
-Some tests will fail. Here is which, and why:
-
-=over 8
-
-=item F<io/fs.t>, F<op/stat.t>, F<lib/*dbm.t>, F<lib/db-*.t>
-
-Check I<file system> operations. Failures result from the inability to
-emulate some Unixisms with the standard Amiga filesystem.
+Some tests will be skipped because they need the fork() function:
 
-=item 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>
-
-These tests will be skipped because they use the fork() function, which is not
-supported under AmigaOS.
-
-=item F<op/magic.t>
-
-The ixemul.library doesn't set the expected values for $0 and $^X.
-
-=back
+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
 
@@ -226,9 +240,10 @@ Run
 
   make install
 
-=head1 AUTHOR
+=head1 AUTHORS
 
 Norbert Pueschel, pueschel@imsdd.meb.uni-bonn.de
+Jan-Erik Karlsson, trg@privat.utfors.se
 
 =head1 SEE ALSO