version 2, including all changes.
.
| Rev |
Author |
# |
Line |
| 1 |
perry |
1 |
PERLAMIGA |
| |
|
2 |
!!!PERLAMIGA |
| |
|
3 |
NAME |
| |
|
4 |
SYNOPSIS |
| |
|
5 |
DESCRIPTION |
| |
|
6 |
INSTALLATION |
| |
|
7 |
Accessing documentation |
| |
|
8 |
BUILD |
| |
|
9 |
AUTHORS |
| |
|
10 |
SEE ALSO |
| |
|
11 |
---- |
| |
|
12 |
!!NAME |
| |
|
13 |
|
| |
|
14 |
|
| |
|
15 |
perlamiga - Perl under Amiga OS |
| |
|
16 |
!!SYNOPSIS |
| |
|
17 |
|
| |
|
18 |
|
| |
|
19 |
One can read this document in the following |
| |
|
20 |
formats: |
| |
|
21 |
|
| |
|
22 |
|
| |
|
23 |
man perlamiga |
| |
|
24 |
multiview perlamiga.guide |
| |
|
25 |
to list some (not all may be available simultaneously), or it may be read ''as is'': either as ''README .amiga'', or ''pod/perlamiga.pod''. |
| |
|
26 |
|
| |
|
27 |
|
| |
|
28 |
A recent version of perl for the Amiga can be found at the |
| |
|
29 |
Geek Gadgets section of the Aminet: |
| |
|
30 |
|
| |
|
31 |
|
| |
|
32 |
http://www.aminet.net/~aminet/dirs/dev_gg.html |
| |
|
33 |
!!DESCRIPTION |
| |
|
34 |
|
| |
|
35 |
|
| |
|
36 |
__Prerequisites__ |
| |
|
37 |
|
| |
|
38 |
|
| |
|
39 |
__Unix emulation for AmigaOS: |
| |
|
40 |
ixemul.library__ |
| |
|
41 |
|
| |
|
42 |
|
| |
|
43 |
You need the Unix emulation for AmigaOS, whose most |
| |
|
44 |
important part is __ixemul.library__. For a minimum |
| |
|
45 |
setup, get the latest versions of the following packages |
| |
|
46 |
from the Aminet archives |
| |
|
47 |
(http://www.aminet.net/~aminet/): |
| |
|
48 |
|
| |
|
49 |
|
| |
|
50 |
ixemul-bin |
| |
|
51 |
ixemul-env-bin |
| |
|
52 |
pdksh-bin |
| |
|
53 |
Note also that this is a minimum setup; you might want to add other packages of __ADE__ (the ''Amiga Developers Environment''). |
| |
|
54 |
|
| |
|
55 |
|
| |
|
56 |
__Version of Amiga OS__ |
| |
|
57 |
|
| |
|
58 |
|
| |
|
59 |
You need at the very least AmigaOS version 2.0. Recommended |
| |
|
60 |
is version 3.1. |
| |
|
61 |
|
| |
|
62 |
|
| |
|
63 |
__Starting Perl programs under AmigaOS__ |
| |
|
64 |
|
| |
|
65 |
|
| |
|
66 |
Start your Perl program ''foo'' with arguments arg1 |
| |
|
67 |
arg2 arg3 the same way as on any other platform, |
| |
|
68 |
by |
| |
|
69 |
|
| |
|
70 |
|
| |
|
71 |
perl foo arg1 arg2 arg3 |
| |
|
72 |
If you want to specify perl options -my_opts to the perl itself (as opposed to to your program), use |
| |
|
73 |
|
| |
|
74 |
|
| |
|
75 |
perl -my_opts foo arg1 arg2 arg3 |
| |
|
76 |
Alternately, you can try to get a replacement for the system's __Execute__ command that honors the #!/usr/bin/perl syntax in scripts and set the s-Bit of your scripts. Then you can invoke your scripts like under UNIX with |
| |
|
77 |
|
| |
|
78 |
|
| |
|
79 |
foo arg1 arg2 arg3 |
| |
|
80 |
(Note that having *nixish full path to perl ''/usr/bin/perl'' is not necessary, ''perl'' would be enough, but having full path would make it easier to use your script under *nix.) |
| |
|
81 |
|
| |
|
82 |
|
| |
|
83 |
__Shortcomings of Perl under AmigaOS__ |
| |
|
84 |
|
| |
|
85 |
|
| |
|
86 |
Perl under AmigaOS lacks some features of perl under |
| |
|
87 |
UNIX because of deficiencies in the |
| |
|
88 |
UNIX-emulation, most notably: |
| |
|
89 |
|
| |
|
90 |
|
| |
|
91 |
''fork()'' |
| |
|
92 |
|
| |
|
93 |
|
| |
|
94 |
some features of the UNIX filesystem |
| |
|
95 |
regarding link count and file dates |
| |
|
96 |
|
| |
|
97 |
|
| |
|
98 |
inplace operation (the __-i__ switch) without backup |
| |
|
99 |
file |
| |
|
100 |
|
| |
|
101 |
|
| |
|
102 |
''umask()'' works, but the correct permissions are only |
| |
|
103 |
set when the file is finally ''close()''d |
| |
|
104 |
!!INSTALLATION |
| |
|
105 |
|
| |
|
106 |
|
| |
|
107 |
Change to the installation directory (most probably |
| |
|
108 |
ADE: ), and extract the binary |
| |
|
109 |
distribution: |
| |
|
110 |
|
| |
|
111 |
|
| |
|
112 |
lha -mraxe x perl-$VERSION-bin.lha |
| |
|
113 |
|
| |
|
114 |
|
| |
|
115 |
or |
| |
|
116 |
|
| |
|
117 |
|
| |
|
118 |
tar xvzpf perl-$VERSION-bin.tgz |
| |
|
119 |
|
| |
|
120 |
|
| |
|
121 |
(Of course you need lha or tar and gunzip for |
| |
|
122 |
this.) |
| |
|
123 |
|
| |
|
124 |
|
| |
|
125 |
For installation of the Unix emulation, read the appropriate |
| |
|
126 |
docs. |
| |
|
127 |
!!Accessing documentation |
| |
|
128 |
|
| |
|
129 |
|
| |
|
130 |
__Manpages__ |
| |
|
131 |
|
| |
|
132 |
|
| |
|
133 |
If you have man installed on your system, and you |
| |
|
134 |
installed perl manpages, use something like |
| |
|
135 |
this: |
| |
|
136 |
|
| |
|
137 |
|
| |
|
138 |
man perlfunc |
| |
|
139 |
man less |
| 2 |
perry |
140 |
man !ExtUtils.!MakeMaker |
| 1 |
perry |
141 |
to access documentation for different components of Perl. Start with |
| |
|
142 |
|
| |
|
143 |
|
| |
|
144 |
man perl |
| |
|
145 |
Note: You have to modify your man.conf file to search for manpages in the /ade/lib/perl5/man/man3 directory, or the man pages for the perl library will not be found. |
| |
|
146 |
|
| |
|
147 |
|
| |
|
148 |
Note that dot (''.'') is used as a package separator for |
| |
|
149 |
documentation for packages, and as usual, sometimes you need |
| |
|
150 |
to give the section - 3 above - to avoid shadowing |
| |
|
151 |
by the ''less(1) manpage''. |
| |
|
152 |
|
| |
|
153 |
|
| |
|
154 |
__HTML__ |
| |
|
155 |
|
| |
|
156 |
|
| |
|
157 |
If you have some WWW browser available, you |
| |
|
158 |
can build __HTML__ docs. Cd to directory |
| |
|
159 |
with ''.pod'' files, and do like this |
| |
|
160 |
|
| |
|
161 |
|
| |
|
162 |
cd /ade/lib/perl5/pod |
| |
|
163 |
pod2html |
| |
|
164 |
After this you can direct your browser the file ''perl.html'' in this directory, and go ahead with reading docs. |
| |
|
165 |
|
| |
|
166 |
|
| |
|
167 |
Alternatively you may be able to get these docs prebuilt |
| |
|
168 |
from CPAN. |
| |
|
169 |
|
| |
|
170 |
|
| |
|
171 |
__GNU__ info |
| |
|
172 |
__files__ |
| |
|
173 |
|
| |
|
174 |
|
| |
|
175 |
Users of Emacs would appreciate it very much, |
| |
|
176 |
especially with CPerl mode loaded. You need to get |
| |
|
177 |
latest pod2info from CPAN, or, |
| |
|
178 |
alternately, prebuilt info pages. |
| |
|
179 |
|
| |
|
180 |
|
| |
|
181 |
LaTeX __docs__ |
| |
|
182 |
|
| |
|
183 |
|
| |
|
184 |
can be constructed using pod2latex. |
| |
|
185 |
!!BUILD |
| |
|
186 |
|
| |
|
187 |
|
| |
|
188 |
Here we discuss how to build Perl under |
| |
|
189 |
AmigaOS. |
| |
|
190 |
|
| |
|
191 |
|
| |
|
192 |
__Prerequisites__ |
| |
|
193 |
|
| |
|
194 |
|
| |
|
195 |
You need to have the latest __ixemul__ (Unix emulation |
| |
|
196 |
for Amiga) from Aminet. |
| |
|
197 |
|
| |
|
198 |
|
| |
|
199 |
__Getting the perl source__ |
| |
|
200 |
|
| |
|
201 |
|
| |
|
202 |
You can either get the latest perl-for-amiga source from |
| |
|
203 |
Ninemoons and extract it with: |
| |
|
204 |
|
| |
|
205 |
|
| |
|
206 |
tar xvzpf perl-$VERSION-src.tgz |
| |
|
207 |
or get the official source from CPAN: |
| |
|
208 |
|
| |
|
209 |
|
| |
|
210 |
http://www.perl.com/CPAN/src/5.0 |
| |
|
211 |
Extract it like this |
| |
|
212 |
|
| |
|
213 |
|
| |
|
214 |
tar xvzpf perl-$VERSION.tar.gz |
| |
|
215 |
You will see a message about errors while extracting ''Configure''. This is normal and expected. (There is a conflict with a similarly-named file ''configure'', but it causes no harm.) |
| |
|
216 |
|
| |
|
217 |
|
| |
|
218 |
__Making__ |
| |
|
219 |
|
| |
|
220 |
|
| |
|
221 |
remember to use a healthy sized stack (I used |
| |
|
222 |
2000000) |
| |
|
223 |
|
| |
|
224 |
|
| |
|
225 |
your PATH environment variable must include |
| |
|
226 |
/bin (e.g. ``.:/bin'' is good) (or, more precisely, it must |
| |
|
227 |
include the directory where you have your basic |
| |
|
228 |
UNIX utilities like test, cat, sed, and so |
| |
|
229 |
on) |
| |
|
230 |
|
| |
|
231 |
|
| |
|
232 |
sh Configure -Dprefix=/ade -Dloclibpth=/ade/lib |
| |
|
233 |
|
| |
|
234 |
|
| |
|
235 |
fix makedepend |
| |
|
236 |
|
| |
|
237 |
|
| |
|
238 |
In the file 'makedepend' there are three spots like this `$cat ...`: |
| |
|
239 |
a for loop near line 75, an egrep near line 161, and a for loop near |
| |
|
240 |
line 175. In all those spots using an editor change the $cat to |
| |
|
241 |
/bin/cat. |
| |
|
242 |
|
| |
|
243 |
|
| |
|
244 |
now type make depend |
| |
|
245 |
|
| |
|
246 |
|
| |
|
247 |
When the make depend has ended load the gnumakefile into |
| |
|
248 |
an editor and go to the end of the file. |
| |
|
249 |
Move upwards in the file until you reach av.o: EXTERN.h |
| |
|
250 |
and delete all lines down to # WARNING: Put.... |
| |
|
251 |
|
| |
|
252 |
|
| |
|
253 |
now go to the x2p directory |
| |
|
254 |
|
| |
|
255 |
|
| |
|
256 |
Load the gnumakefile into an editor. |
| |
|
257 |
Go to the end moveup until you reach hash.o: EXTERN.h |
| |
|
258 |
and delete all lines dowonwards until you reach a line saying |
| |
|
259 |
# WARNING: Put nothing.... |
| |
|
260 |
|
| |
|
261 |
|
| |
|
262 |
Now! |
| |
|
263 |
|
| |
|
264 |
|
| |
|
265 |
make |
| |
|
266 |
|
| |
|
267 |
|
| |
|
268 |
__Testing__ |
| |
|
269 |
|
| |
|
270 |
|
| |
|
271 |
Now run |
| |
|
272 |
|
| |
|
273 |
|
| |
|
274 |
make test |
| |
|
275 |
Some tests will be skipped because they need the ''fork()'' function: |
| |
|
276 |
|
| |
|
277 |
|
| |
|
278 |
''io/pipe.t'', ''op/fork.t'', ''lib/filehand.t'', |
| |
|
279 |
''lib/open2.t'', ''lib/open3.t'', |
| |
|
280 |
''lib/io_pipe.t'', ''lib/io_sock.t'' |
| |
|
281 |
|
| |
|
282 |
|
| |
|
283 |
__Installing the built perl__ |
| |
|
284 |
|
| |
|
285 |
|
| |
|
286 |
Run |
| |
|
287 |
|
| |
|
288 |
|
| |
|
289 |
make install |
| |
|
290 |
!!AUTHORS |
| |
|
291 |
|
| |
|
292 |
|
| |
|
293 |
Norbert Pueschel, pueschel@imsdd.meb.uni-bonn.de Jan-Erik |
| |
|
294 |
Karlsson, trg@privat.utfors.se |
| |
|
295 |
!!SEE ALSO |
| |
|
296 |
|
| |
|
297 |
|
| |
|
298 |
perl(1). |
| |
|
299 |
---- |
