1 If you read this file _as_is_, just ignore the funny characters you
2 see. It is written in the POD format (see perlpod manpage) which is
3 specially designed to be readable as is.
7 perlamiga - Perl under Amiga OS
11 One can read this document in the following formats:
14 multiview perlamiga.guide
16 to list some (not all may be available simultaneously), or it may
17 be read I<as is>: either as F<README.amiga>, or F<pod/perlamiga.pod>.
19 A recent version of perl for the Amiga can be found at the Geek Gadgets
20 section of the Aminet:
22 http://www.aminet.net/~aminet/dirs/dev_gg.html
28 perlamiga - Perl under Amiga OS
34 - Starting Perl programs under AmigaOS
35 - Shortcomings of Perl under AmigaOS
37 Accessing documentation
44 - Getting the perl source
45 - Application of the patches
48 - Installing the built perl
58 =item B<Unix emulation for AmigaOS: ixemul.library>
60 You need the Unix emulation for AmigaOS, whose most important part is
61 B<ixemul.library>. For a minimum setup, get the latest versions
62 of the following packages from the Aminet archives (http://www.aminet.net/~aminet/):
68 Note also that this is a minimum setup; you might want to add other
69 packages of B<ADE> (the I<Amiga Developers Environment>).
71 =item B<Version of Amiga OS>
73 You need at the very least AmigaOS version 2.0. Recommended is version 3.1.
77 =head2 Starting Perl programs under AmigaOS
79 Start your Perl program F<foo> with arguments C<arg1 arg2 arg3> the
80 same way as on any other platform, by
82 perl foo arg1 arg2 arg3
84 If you want to specify perl options C<-my_opts> to the perl itself (as
85 opposed to to your program), use
87 perl -my_opts foo arg1 arg2 arg3
89 Alternately, you can try to get a replacement for the system's B<Execute>
90 command that honors the #!/usr/bin/perl syntax in scripts and set the s-Bit
91 of your scripts. Then you can invoke your scripts like under UNIX with
95 (Note that having *nixish full path to perl F</usr/bin/perl> is not
96 necessary, F<perl> would be enough, but having full path would make it
97 easier to use your script under *nix.)
99 =head2 Shortcomings of Perl under AmigaOS
101 Perl under AmigaOS lacks some features of perl under UNIX because of
102 deficiencies in the UNIX-emulation, most notably:
108 =item some features of the UNIX filesystem regarding link count and file dates
110 =item inplace operation (the -i switch) without backup file
112 =item umask() works, but the correct permissions are only set when the file is
119 Change to the installation directory (most probably ADE:), and
120 extract the binary distribution:
122 lha -mraxe x perl-$VERSION-bin.lha
126 tar xvzpf perl-$VERSION-bin.tgz
128 (Of course you need lha or tar and gunzip for this.)
130 For installation of the Unix emulation, read the appropriate docs.
132 =head1 Accessing documentation
136 If you have C<man> installed on your system, and you installed perl
137 manpages, use something like this:
141 man ExtUtils.MakeMaker
143 to access documentation for different components of Perl. Start with
147 Note: You have to modify your man.conf file to search for manpages
148 in the /ade/lib/perl5/man/man3 directory, or the man pages for the
149 perl library will not be found.
151 Note that dot (F<.>) is used as a package separator for documentation
152 for packages, and as usual, sometimes you need to give the section - C<3>
153 above - to avoid shadowing by the I<less(1) manpage>.
158 If you have some WWW browser available, you can build B<HTML> docs.
159 Cd to directory with F<.pod> files, and do like this
161 cd /ade/lib/perl5/pod
164 After this you can direct your browser the file F<perl.html> in this
165 directory, and go ahead with reading docs.
167 Alternatively you may be able to get these docs prebuilt from C<CPAN>.
169 =head2 B<GNU> C<info> files
171 Users of C<Emacs> would appreciate it very much, especially with
172 C<CPerl> mode loaded. You need to get latest C<pod2info> from C<CPAN>,
173 or, alternately, prebuilt info pages.
177 can be constructed using C<pod2latex>.
181 Here we discuss how to build Perl under AmigaOS.
185 You need to have the latest B<ixemul> (Unix emulation for Amiga)
188 =head2 Getting the perl source
190 You can either get the latest perl-for-amiga source from Ninemoons
193 tar xvzpf perl-$VERSION-src.tgz
195 or get the official source from CPAN:
197 http://www.perl.com/CPAN/src/5.0
201 tar xvzpf perl-$VERSION.tar.gz
203 You will see a message about errors while extracting F<Configure>. This
204 is normal and expected. (There is a conflict with a similarly-named file
205 F<configure>, but it causes no harm.)
213 remember to use a healthy sized stack (I used 2000000)
217 your PATH environment variable must include /bin (e.g. ".:/bin" is good)
218 (or, more precisely, it must include the directory where you have your
219 basic UNIX utilities like test, cat, sed, and so on)
223 sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib
229 In the file 'makedepend' there are three spots like this `$cat ...`:
230 a for loop near line 75, an egrep near line 161, and a for loop near
231 line 175. In all those spots using an editor change the $cat to
238 When the make depend has ended load the gnumakefile into
239 an editor and go to the end of the file.
241 Move upwards in the file until you reach av.o: EXTERN.h
242 and delete all lines down to # WARNING: Put....
246 now go to the x2p directory
248 Load the gnumakefile into an editor.
250 Go to the end moveup until you reach hash.o: EXTERN.h
251 and delete all lines dowonwards until you reach a line saying
253 # WARNING: Put nothing....
269 Some tests will be skipped because they need the fork() function:
271 F<io/pipe.t>, F<op/fork.t>, F<lib/filehand.t>, F<lib/open2.t>, F<lib/open3.t>,
272 F<lib/io_pipe.t>, F<lib/io_sock.t>
274 =head2 Installing the built perl
282 Norbert Pueschel, pueschel@imsdd.meb.uni-bonn.de
283 Jan-Erik Karlsson, trg@privat.utfors.se