X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=README.amiga;h=3b2a1bda9d28c49aceb6ba52d8e5ccb1b9b6910e;hb=7d3fb23018f73b213481a8b6b108e1dc03cefcff;hp=8951f355a09f2f9195028099c325eaf6a0cfe28d;hpb=ee8c7f5465f003860e2347a2946abacac39bd9b9;p=p5sagit%2Fp5-mst-13.2.git diff --git a/README.amiga b/README.amiga index 8951f35..3b2a1bd 100644 --- a/README.amiga +++ b/README.amiga @@ -4,18 +4,10 @@ specially designed to be readable as is. =head1 NAME -perlamiga - Perl under Amiga OS (possibly very outdated information) +perlamiga - Perl under Amiga OS =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 @@ -24,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 @@ -61,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: +B. For a minimum setup, get the latest versions +of the following packages from the Aminet archives (http://www.aminet.net/~aminet/): -ixemul-46.0-bin.lha -ixemul-46.0-env-bin.lha -pdksh-4.9-bin.lha -ADE-misc-bin.lha - -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). @@ -108,16 +101,24 @@ easier to use your script under *nix.) Perl under AmigaOS lacks some features of perl under UNIX because of deficiencies in the UNIX-emulation, most notably: -=over 6 +=over 4 + +=item * + +fork() -=item fork() +=item * -=item some features of the UNIX filesystem regarding link count and file dates +some features of the UNIX filesystem regarding link count and file dates -=item inplace operation (the -i switch) without backup file +=item * -=item umask() works, but the correct permissions are only set when the file is - finally close()d +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 @@ -126,11 +127,11 @@ deficiencies in the UNIX-emulation, most notably: 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.) @@ -189,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: @@ -206,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 @@ -214,12 +214,60 @@ F, but it causes no harm.) =head2 Making - sh configure.gnu --prefix=/ade +=over 4 + +=item * + +remember to use a healthy sized stack (I used 2000000) + +=item * + +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) + +=item * + + sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib -Now +=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 * + +now type make depend + + When the make depend has ended load the gnumakefile into + an editor and go to the end of the file. + + Move upwards in the file until you reach av.o: EXTERN.h + and delete all lines down to # WARNING: Put.... + +=item * + +now go to the x2p directory + + Load the gnumakefile into an editor. + + Go to the end moveup until you reach hash.o: EXTERN.h + and delete all lines dowonwards until you reach a line saying + + # WARNING: Put nothing.... + +=item * + +Now! make +=back + =head2 Testing Now run @@ -237,9 +285,10 @@ 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