=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
DESCRIPTION
- Prerequisites
- Starting Perl programs under AmigaOS
+ - Shortcomings of Perl under AmigaOS
INSTALLATION
Accessing documentation
- Manpages
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
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
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