X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.amiga;h=8951f355a09f2f9195028099c325eaf6a0cfe28d;hb=cc50a2034c8f38d702b126ee0ae87fcad255227a;hp=110f9cf69652dcef944f54064b3d541c69bd6e0d;hpb=f86702ccfcc3646d7aa30b09ce4f4413be9f99d1;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.amiga b/README.amiga index 110f9cf..8951f35 100644 --- 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. 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 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,26 +226,10 @@ Now run make test -Some tests will fail. Here is which, and why: - -=over 8 - -=item F, F, F, F - -Check I 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, F, F, F, - F, F, F - -These tests will be skipped because they use the fork() function, which is not -supported under AmigaOS. - -=item F - -The ixemul.library doesn't set the expected values for $0 and $^X. - -=back +F, F, F, F, F, +F, F =head2 Installing the built perl