X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.amiga;h=3b2a1bda9d28c49aceb6ba52d8e5ccb1b9b6910e;hb=5999ed7d8e1601dce57087d0b16df2b7b3923d34;hp=110f9cf69652dcef944f54064b3d541c69bd6e0d;hpb=f86702ccfcc3646d7aa30b09ce4f4413be9f99d1;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.amiga b/README.amiga index 110f9cf..3b2a1bd 100644 --- 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: either as F, or F. +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 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 -pdksh-4.9-bin.lha -ADE-misc-bin.lha +B. 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 (the I). @@ -94,16 +96,42 @@ 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 4 + +=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 +190,15 @@ Here we discuss how to build Perl under AmigaOS. =head2 Prerequisites -You need to have the latest B (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 (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 +206,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. This is normal and expected. (There is a conflict with a similarly-named file @@ -187,48 +214,81 @@ F, but it causes no harm.) =head2 Making - sh configure.gnu --prefix=/ade +=over 4 -Now +=item * - make +remember to use a healthy sized stack (I used 2000000) -=head2 Testing +=item * -Now run +your PATH environment variable must include /bin (e.g. ".:/bin" is good) +(or, more precisely, it must include the directory where you have your +basic UNIX utilities like test, cat, sed, and so on) - make test +=item * + + sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib + +=item * + +fix makedepend + + In the file 'makedepend' there are three spots like this `$cat ...`: + a for loop near line 75, an egrep near line 161, and a for loop near + line 175. In all those spots using an editor change the $cat to + /bin/cat. + +=item * -Some tests will fail. Here is which, and why: +now type make depend -=over 8 + When the make depend has ended load the gnumakefile into + an editor and go to the end of the file. -=item F, F, F, F + Move upwards in the file until you reach av.o: EXTERN.h + and delete all lines down to # WARNING: Put.... -Check I operations. Failures result from the inability to -emulate some Unixisms with the standard Amiga filesystem. +=item * -=item F, F, F, F, - F, F, F +now go to the x2p directory -These tests will be skipped because they use the fork() function, which is not -supported under AmigaOS. + Load the gnumakefile into an editor. -=item F + Go to the end moveup until you reach hash.o: EXTERN.h + and delete all lines dowonwards until you reach a line saying -The ixemul.library doesn't set the expected values for $0 and $^X. + # WARNING: Put nothing.... + +=item * + +Now! + + make =back +=head2 Testing + +Now run + + make test + +Some tests will be skipped because they need the fork() function: + +F, F, F, F, F, +F, F + =head2 Installing the built perl 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