Re: [PATCH] Re: Speeding up method lookups

[perl5.git] / README.amiga

diff --git a/README.amiga b/README.amiga
index b20c023..8951f35 100644 (file)
--- a/README.amiga
+++ b/README.amiga
@@ -4,10 +4,18 @@ 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: No one has reported building Perl on the Amiga in a long
+time.  The following information is highly unlikely to be correct.
+If you would like to help the Amiga port to stay current, see:
+
+    http://us.aminet.net/aminet/dirs/dev_gg.html
+
+for Amiga resources and information.
+
 One can read this document in the following formats:
 
        man perlamiga
@@ -27,6 +35,7 @@ Contents
        DESCRIPTION 
          -  Prerequisites 
          -  Starting Perl programs under AmigaOS
+         -  Shortcomings of Perl under AmigaOS
        INSTALLATION 
        Accessing documentation 
          -  Manpages 
@@ -55,8 +64,8 @@ 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
+ixemul-46.0-bin.lha
+ixemul-46.0-env-bin.lha
 pdksh-4.9-bin.lha
 ADE-misc-bin.lha
 
@@ -94,6 +103,24 @@ 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
@@ -199,22 +226,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>
+Some tests will be skipped because they need the fork() function:
 
-Check I<file system> operations. Failures result from the inability to
-emulate some Unixisms with the standard Amiga filesystem.
-
-=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.
-
-=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