Fix for README.amiga (20000323.033)

[p5sagit/p5-mst-13.2.git] / README.amiga

diff --git a/README.amiga b/README.amiga
index 110f9cf..fd8e922 100644 (file)
--- a/README.amiga
+++ b/README.amiga
@@ -4,10 +4,15 @@ specially designed to be readable as is.
 
 =head1 NAME
 
-perlamiga - Perl under Amiga OS
+perlamiga - Perl under Amiga OS (possibly very outdated information)
 
 =head1 SYNOPSIS
 
+NOTE: The following information is highly unlikely to be correct.
+A recent version of perl for the Amiga can be found at the Aminet site:
+
+    http://us.aminet.net/aminet/dirs/dev_gg.html
+
 One can read this document in the following formats:
 
        man perlamiga
@@ -27,6 +32,7 @@ Contents
        DESCRIPTION 
          -  Prerequisites 
          -  Starting Perl programs under AmigaOS
+         -  Shortcomings of Perl under AmigaOS
        INSTALLATION 
        Accessing documentation 
          -  Manpages 
@@ -53,12 +59,11 @@ Contents
 
 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:
+the Aminet archives (http://www.aminet.net/~aminet/):
 
-ixemul-45.1-bin.lha
-ixemul-45.1-env-bin.lha
-pdksh-4.9-bin.lha
-ADE-misc-bin.lha
+ixemul-bin.lha
+ixemul-env-bin.lha
+pdksh-bin.lha
 
 Note that there might be newer versions available by the time you read
 this.
@@ -94,16 +99,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 +185,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,7 +201,7 @@ 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
@@ -199,26 +221,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