X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/ee8c7f5465f003860e2347a2946abacac39bd9b9..8528dd49329fbb23f774971136b9f47b44da8bc8:/README.amiga diff --git a/README.amiga b/README.amiga index 8951f35..f558ac3 100644 --- a/README.amiga +++ b/README.amiga @@ -4,17 +4,16 @@ 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: +=head1 NOTE - http://us.aminet.net/aminet/dirs/dev_gg.html +B if you want to help +fixing this problem.> -for Amiga resources and information. +=head1 SYNOPSIS One can read this document in the following formats: @@ -24,6 +23,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/dev/gg/index.html + =cut Contents @@ -43,7 +47,7 @@ Contents - GNU info files - LaTeX docs BUILD - - Prerequisites + - Build Prerequisites - Getting the perl source - Application of the patches - Making @@ -54,23 +58,20 @@ Contents =head1 DESCRIPTION -=head2 Prerequisites +=head2 Prerequisites for Compiling Perl on AmigaOS =over 6 =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). @@ -89,7 +90,7 @@ same way as on any other platform, by perl foo arg1 arg2 arg3 If you want to specify perl options C<-my_opts> to the perl itself (as -opposed to to your program), use +opposed to your program), use perl -my_opts foo arg1 arg2 arg3 @@ -110,14 +111,22 @@ deficiencies in the UNIX-emulation, most notably: =over 6 -=item fork() +=item * + +fork() -=item some features of the UNIX filesystem regarding link count and file dates +=item * -=item inplace operation (the -i switch) without backup file +some features of the UNIX filesystem regarding link count and file dates -=item umask() works, but the correct permissions are only set when the file is - finally close()d +=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 @@ -126,11 +135,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.) @@ -138,7 +147,7 @@ For installation of the Unix emulation, read the appropriate docs. =head1 Accessing documentation -=head2 Manpages +=head2 Manpages for Perl on AmigaOS If you have C installed on your system, and you installed perl manpages, use something like this: @@ -160,7 +169,7 @@ for packages, and as usual, sometimes you need to give the section - C<3> above - to avoid shadowing by the I. -=head2 B +=head2 Perl HTML Documentation on AmigaOS If you have some WWW browser available, you can build B docs. Cd to directory with F<.pod> files, and do like this @@ -173,54 +182,59 @@ directory, and go ahead with reading docs. Alternatively you may be able to get these docs prebuilt from C. -=head2 B C files +=head2 Perl GNU Info Files on AmigaOS Users of C would appreciate it very much, especially with C mode loaded. You need to get latest C from C, or, alternately, prebuilt info pages. -=head2 C docs +=head2 Perl LaTeX Documentation on AmigaOS -can be constructed using C. +Can be constructed using C. -=head1 BUILD +=head1 BUILDING PERL ON AMIGAOS Here we discuss how to build Perl under AmigaOS. -=head2 Prerequisites +=head2 Build Prerequisites for Perl on AmigaOS -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 +=head2 Getting the Perl Source for AmigaOS 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: - http://www.perl.com/CPAN/src/5.0 + http://www.cpan.org/src/5.0 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 F, but it causes no harm.) -=head2 Making +=head2 Making Perl on AmigaOS + +Remember to use a hefty wad of stack (I use 2000000) - sh configure.gnu --prefix=/ade + sh configure.gnu --prefix=/gg -Now +Now type + + make depend + +Now! make -=head2 Testing +=head2 Testing Perl on AmigaOS Now run @@ -231,15 +245,31 @@ Some tests will be skipped because they need the fork() function: F, F, F, F, F, F, F -=head2 Installing the built perl +=head2 Installing the built Perl on AmigaOS Run make install -=head1 AUTHOR +=head1 PERL 5.8.0 BROKEN IN AMIGAOS + +As told above, Perl 5.6.1 was still good in AmigaOS, as was 5.7.2. +After Perl 5.7.2 (change #11423, see the Changes file, and the file +pod/perlhack.pod for how to get the individual changes) Perl dropped +its internal support for vfork(), and that was very probably the step +that broke AmigaOS (since the ixemul library has only vfork). +The build finally fails when the ext/DynaLoader is being built, and +PERL ends up as "0" in the produced Makefile, trying to run "0" does +not quite work. Also, executing miniperl in backticks seems to +generate nothing: very probably related to the (v)fork problems. +B + +=head1 AUTHORS Norbert Pueschel, pueschel@imsdd.meb.uni-bonn.de +Jan-Erik Karlsson, trg@privat.utfors.se =head1 SEE ALSO