X-Git-Url: https://perl5.git.perl.org/perl5.git/blobdiff_plain/0e06870bf080a38cda51c06c6612359afc2334e1..741f88f95256a4a15afe1b98f6b2de834ebc3fe7:/README.amiga diff --git a/README.amiga b/README.amiga index 3b2a1bd..c86adef 100644 --- a/README.amiga +++ b/README.amiga @@ -6,6 +6,13 @@ specially designed to be readable as is. perlamiga - Perl under Amiga OS +=head1 NOTE + +B if you want to help +fixing this problem.> + =head1 SYNOPSIS One can read this document in the following formats: @@ -18,8 +25,8 @@ 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 + + http://www.aminet.net/~aminet/dev/gg =cut @@ -40,7 +47,7 @@ Contents - GNU info files - LaTeX docs BUILD - - Prerequisites + - Build Prerequisites - Getting the perl source - Application of the patches - Making @@ -51,7 +58,7 @@ Contents =head1 DESCRIPTION -=head2 Prerequisites +=head2 Prerequisites for Compiling Perl on AmigaOS =over 6 @@ -59,7 +66,8 @@ Contents You need the Unix emulation for AmigaOS, whose most important part is B. For a minimum setup, get the latest versions -of the following packages from the Aminet archives (http://www.aminet.net/~aminet/): +of the following packages from the Aminet archives +( L ): ixemul-bin ixemul-env-bin @@ -82,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 @@ -101,13 +109,13 @@ 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 4 +=over 6 -=item * +=item * fork() -=item * +=item * some features of the UNIX filesystem regarding link count and file dates @@ -139,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: @@ -161,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 @@ -174,26 +182,26 @@ 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 (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: @@ -202,7 +210,7 @@ and extract it with: 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 @@ -212,63 +220,21 @@ 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 - -=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 - -=item * +=head2 Making Perl on AmigaOS -fix makedepend +Remember to use a hefty wad of stack (I use 2000000) - 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 * + sh configure.gnu --prefix=/gg -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 type -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 * + make depend Now! make -=back - -=head2 Testing +=head2 Testing Perl on AmigaOS Now run @@ -279,12 +245,27 @@ 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 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