perl 5.003_03: perl.h
[perl.git] / README.os2
1 Contents:
2         Notes on the patch
3         IMPORTANT NOTE
4         Target
5         Binary Install
6         Reading the docs
7         Notes on build on OS/2
8         Compile summary
9         Tests which fail
10         Calls to external programs
11         OS/2 extensions
12         Report from the battlefield on 5.002_01
13
14 Notes on the patch:
15 ~~~~~~~~~~~~~~~~~~~
16 patches should be applied as
17         patch -p0 <.....
18 All the diff.* files and POSIX.mkfifo should be applied.
19
20 Additional files are available on
21         ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
22 including patched pdksh and gnumake, needed for build.
23
24                    <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
25 IMPORTANT NOTE     <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
26                    <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
27
28 Note with the release 5.003_01 the dynamically loadable libraries
29 should be rebuilt. In particular, DLLs are now created with the names
30 which contain a checksum, thus allowing workaround for OS/2 scheme of
31 caching DLLs.
32
33 In particular, it is VERY IMPORTANT to have a correct perl.dll on
34 LIBPATH during build, otherwise DLLs with wrong names will be
35 created. Or have a perl.dll with the same naming convention for DLLs
36 (hopefully, it should not change any time soon), or remove it from
37 LIBPATH, add . to LIBPATH, wait until the build of DynaLoader fails,
38 and then move the built DLL into LIBPATH.
39
40 I also used this possibility to change perl linking type to -Zmt. It
41 means that Perl now uses multithreaded CRTDLL, so your extensions can
42 be multithreaded (note that the perl core is not thread-safe so far,
43 so make sure you access Perl from one thread only). In particular, it
44 is no longer needed to statically link X11_s.lib if you compile
45 Perl/Tk/XFree.
46
47 This newer port includes 
48         . numeric first argument to system(), see OS2::Process docs;
49         . modules OS2::Process, OS2::REXX, OS2::PrfDB, OS2::ExtAttrib.
50         . {get,set,end}*ent may work now (not checked)
51 (most of this merged from ak's port).
52
53 Note that static build of OS2::ExtAttrib fails some tests!
54
55 Target:
56 ~~~~~~~
57
58 This is not supposed to make a perfect Perl on OS/2. This patch is
59 concerned only with perfect _build_ of Perl on OS/2. Some good
60 features from Andreas Kaiser port missed this port. However, most of
61 the features are available (possibly in different form). 
62
63 !!! Note that [gs]etpriority functions in this port are compatible
64 !!! with *nix, not with ak's port!!! 
65
66 The priorities are absolute, go from 32 to -95, lower is quickier. 0
67 is default,
68
69 Binary Install:
70 ~~~~~~~~~~~~~~
71 This version of perl allows binary installation on another site. There
72 are two possibilities:
73         a) sh.exe is in the directory with the same name as on machine
74 where perl was compiled (f:/bin here), and perl library is installed
75 into the same directory as the built target (f:/perllib);
76         b) One of the above conditions is not true. Perl may be
77 informed about location of sh.exe via PERL_SH_DRIVE or PERL_SH_DIR
78 (see below). To relocate the perl library, one can
79         b1) either use the usual PERLLIB environment variable - but
80 you should deduce yourself which components should be put there, say,
81 by doing 
82                 perl -de 0
83                 x \@INC
84                 q
85 in the directory of the perl library. Another problem with this is
86 that a module is missing, then perl will try to scan the builtin
87 directories nevertheless. If perl was intended to be installed on
88 f:/perllib, but your f: is a CDROM, then you may have some trouble.
89         b2) Best: binary edit perl.dll and perl_.exe (using perl
90 itself as a binary editor) to fix the paths. Note that the new paths
91 should be better no longer than the old.
92         b3) More convinient: set PERLLIB_PREFIX environment
93 variable. It should contain two components, separated by whitespace
94 and/or semicolon `;'. The first component is translated to the second
95 one if it is 
96              a prefix of 
97                          a component of
98                                         Perl library lookup path.
99 Say, if you install perllibrary into c:/lib/perl/ instead of
100 f:/perllib/, set it to
101         set PERLLIB_PREFIX=f:/perllib/;c:/lib/perl/
102
103 Reading the docs:
104 ~~~~~~~~~~~~~~~~
105 If your `man' is correctly installed, you should just add
106 x:/perllib/man directory to the end of MANPATH like this:
107         set MANPATH=c:/man;f:/perllib/man
108 After this you can access the docs like this:
109         man perlfunc
110         man 3 less
111         man ExtUtils.MakeMaker
112 Note that dot is used as package separator for package documentation,
113 and as usual, sometimes you need to give the section - 3 above - to
114 avoid shadowing by the less(1) manpage.
115
116 Alternatively, you can build HTML docs by running
117         pod2html
118 in x:/perllib/lib/pod directory.
119
120 Alternatively, you can build IPF source by running
121         pod2ipf > perl.ipf
122 in x:/perllib/lib/pod directory, and build (excellent! - best of perl
123 docs available!) .INF documentation by running
124         ipfc /inf perl.ipf
125 Move it on your BOOKSHELF path, and now you may inspect docs by
126         view perl
127 or
128         view perl keyword_to_see
129
130 Alternatively you may pick up precompiled HTML and .INF docs from the
131 net, as usual, .INF is available on CPAN/.../os2/ilyaz.
132
133 There are also _very_ good docs in TexInfo and Adobe PDF format.
134
135 Notes on build on OS/2:
136 ~~~~~~~~~~~~~~~~~~~~~~~
137 a) Make sure your sort is not the broken OS/2 one, and that you have /tmp
138 on the build partition. Make sure that your pdksh.exe, make.exe and
139 db.lib are OK (look elsewhere in this file).
140
141 b) when extracting perl5.*.tar.gz you need to extract perl5.*/Configure
142 separately, since by default perl5.001m/configure may overwrite it;
143         like this:
144                 tar vzxf perl5.004.tar.gz --case-sensitive perl5.004/Configure
145 or
146                 tar --case-sensitive -vzxf perl5.004.tar.gz perl5.004/Configure
147
148 c) Necessary manual intervention when compiling on OS/2:
149
150         Need to put perl.dll on LIBPATH after it is created.
151
152 d) Compile summary:
153    ~~~~~~~~~~~~~~~
154 !!! At the end of this README is independent description of the build
155 !!! process by Rocco Caputo.
156
157 # Look for hints/os2.sh and correct what is different on your system
158 # I have rather spartan configuration.
159
160         # Prefix means where to install:
161 sh Configure -des -D prefix=f:/perl5.005
162         # Note that you need to have /tmp/ ready.
163         #
164         # Ignore the message about missing `ln', and about `c' option
165         # to tr.
166 make
167         # Will probably die after build of miniperl (unless you have DLL
168         # from previous compile). Need to move DLL where it belongs
169         #
170         # Somehow with 5.002b3 I needed to type another make after pod2man
171 make
172         # some warnings in POSIX.c
173 make test
174         # some tests fail, 9 or 10 on my system (see the list at end).
175         #
176         # before this you should create subdirs bin and lib in the 
177         # prefix directory (f:/perl5.005 above):
178         #
179         # To run finer tests, cd t && perl harness
180 make install
181
182 e) At the end of July 1996 GNU make was too buggy for compile.
183 The maintainer has the patch (for a year now) that make it possible to
184 compile perl. The binaries are included in
185         ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
186 patches are available too.
187
188 Note that the pdksh5.2.7 or later is required.
189
190 !!!!!!!!!!!!!!!!!
191 If you see that some '/' became '\' in pdksh, you use an old pdksh!
192 Same with segfaults in Make 3.76 (?) - use my patched verions.
193 !!!!!!!!!!!!!!!!!
194
195 f) As distributed the DB library db.a-db.lib is not suitable for
196 linking with -Zmt. A recompiled version must be available from my FTP
197 site in os2/db_mt.zip.
198
199 !!!!!!!!!!!!!!!!
200 If you see: 
201         'errno' - unresolved external
202 it means you use a wrong db.lib.
203 !!!!!!!!!!!!!!!!
204
205 Problems reported: 
206
207 a) one of the latest tr is broken, get an old one :-(
208         1.11 works. (On compuserver?)
209 b) You need a perlglob.exe and link386.
210 c) Get rid of invalid perl.dll on your LIBPATH.
211
212
213 Send comments to ilya@math.ohio-state.edu.
214
215 ======================================================
216 Requires 0.9b (well, provision are made to make it build under 0.9a6,
217 but they are not tested, please inform me on success).
218 (earlier than 0.9b ttyname was not present, it is hard to maintain this
219 difference automatically, though I try).
220 ======================================================
221
222 Building with a.out style is supported by the `perl_' target of make.
223 Dynamic extensions are not possible with perl_.exe, since boot code
224 should return the retvalue on the Perl stack, the address of which is
225 not known to the extension. Moreover: The build process for `perl_'
226 DOES NOT KNOW about dependencies, so you should make sure that
227 anything is up-to-date, say, by doing
228         make perl.dll
229 first.
230
231 The reason why compiling with a.out style executables leads to problems
232 with dynamic extensions is:
233         a) OS/2 does not export symbols from executables;
234         b) Thus if extension needs to import symbols from an application
235                 the symbols for the application should reside in a .dll.
236         c) You cannot export data from a .dll compiled with a.out style.
237 On the other hand, aout-style compiled extension enjoys all the 
238 (dis)advantages of fork().
239
240 ======================================================
241
242 If you need to run PM code from perl, you may use PM mode executable
243 perl__.exe. It is subject to restrictions specific to PM programs: it
244 will close the VIO window the moment any PM call is performed.
245
246 It is needed to run Perl/Tk (currently 7/96 - pre-alpha).
247
248 ======================================================
249
250 The reason why the executables are named perl_.exe and perl__.exe is
251 the following: Perl may parse #! lines in perl scripts to find out the
252 additional switches to enable. Thus there is a convention `What is a
253 perl executable - judging by name', and the above names conform to
254 this convention.
255
256 ======================================================
257 Tests which fail 
258 ~~~~~~~~~~~~~~~~
259 with OMF compile (fork works - and all the related
260 test - with A.OUT compile):
261
262 io/fs.t: 2-5, 7-11, 18  as they should.
263 io/pipe: all, since open("|-") is not working (works with perl_.exe).
264 lib/"all the dbm".t: 1 test should fail (file permission).
265 lib/io_pipe io_sock, as they should: use fork.
266 op/fork all fail, as they should (except with perl_.exe)
267 op/stat 3 20 35 as they should, 39 (-t on /dev/null) ???? Sometimes 4
268 - timing problem ????
269
270 Sometimes I have seen segfault in socket ????, only if run with Testing tools.
271
272 A lot of `bad free'... in databases, bug in DB confirmed on other
273 platforms. You may disable it by setting PERL_BADFREE environment variable
274 to 0.
275
276 Here is my result with OMF:
277
278 Test         Status Wstat Total Fail Success  List of failed
279 ------------------------------------------------------------------------------
280 io/fs.t                      22   10  45.45%  2-5, 7-11, 18
281 io/pipe.t         1   256     8   ??       %  ??
282 lib/anydbm.t                 12    1   8.33%  2
283 lib/db-btree.t               86    1   1.16%  20
284 lib/db-hash.t                43    1   2.33%  16
285 lib/db-recno.t               35    1   2.86%  18
286 lib/io_pipe.t     2   512     6   ??       %  ??
287 lib/io_sock.t   255 65280     5   ??       %  ??
288 lib/sdbm.t                   12    1   8.33%  2
289 op/exec.t                     8    1  12.50%  5
290 op/fork.t       255 65280     2   ??       %  ??
291 op/stat.t                    56    4   7.14%  3, 20, 35, 39
292 Failed 12/104 test scripts, 88.46% okay. 41/2224 subtests failed, 98.16% okay.
293
294 and with A.OUT:
295
296 Test         Status Wstat Total Fail  Failed  List of failed
297 ------------------------------------------------------------------------------
298 io/fs.t                      22   10  45.45%  2-5, 7-11, 18
299 lib/anydbm.t                 12    1   8.33%  2
300 lib/db-btree.t               86    1   1.16%  20
301 lib/db-hash.t                43    1   2.33%  16
302 lib/db-recno.t               35    1   2.86%  18
303 lib/sdbm.t                   12    1   8.33%  2
304 op/exec.t                     8    1  12.50%  5
305 op/stat.t                    56    4   7.14%  3, 20, 35, 39
306 Failed 8/104 test scripts, 92.31% okay. 20/2224 subtests failed, 99.10% okay.
307
308 Note that op/exec.5 fail because I do not have /bin/sh on this drive.
309
310 With newer configs I could not reproduce most the crashes. However,
311 after fixpak17 REXX variables acquire a trailing '\0' at end when go
312 through the variable pool (even if they had one), thus making some
313 REXX tests fail.
314
315 =======================================================
316
317 Calls to external programs:
318 ~~~~~~~~~~~~~~~~~~~~~~~~~~
319 Due to a popular demand the perl external program calling has been
320 changed.  _If_ perl needs to call an external program _via shell_, the
321 X:/bin/sh.exe will be called. The name of the shell is 
322 overridable, as described below.
323
324 Thus means that you need to pickup some copy of a sh.exe as well (I use one
325 from pdksh). The drive X: above is set up automatically during the
326 build, is settable in runtime from $ENV{PERL_SH_DRIVE}. Another way to
327 change it is to set $ENV{PERL_SH_DIR} to be the directory in which
328 sh.exe resides.
329
330 Reasons: a consensus on perl5-porters was that perl should use one 
331 non-overridable shell per platform. The obvious choices for OS/2 are cmd.exe
332 and sh.exe. Having perl build itself would be impossible with cmd.exe as
333 a shell, thus I picked up sh.exe. Thus assures almost 100% compatibility
334 with the scripts coming from *nix.
335
336 Disadvantages: sh.exe calls external programs via fork/exec, and there is
337 _no_ functioning exec on OS/2. exec is emulated by EMX by asyncroneous call
338 while the caller waits for child completion (to pretend that pid did
339 not change). This means that 1 _extra_ copy of sh.exe is made active via
340 fork/exec, which may lead to some resources taken from the system.
341
342 The long-term solution proposed on p5-p is to have a directive
343         use OS2::Cmd;
344 which will override system(), exec(), ``, and open(,'   |'). With current
345 perl you may override only system(), readpipe() - the explicit version
346 of ``, and maybe exec(). The code will substitute a one-argument system
347 by CORE::system('cmd.exe', '/c', shift).
348
349 If you have some working code for OS2::Cmd.pm, please send it to me,
350 I will include it into distribution. I have no need for such a module, so
351 cannot test it.
352
353 ===================================================
354
355 OS/2 extensions
356 ~~~~~~~~~~~~~~~
357 Since binaries cannot go into perl distribution, no extensions are
358 included. They are available in .../os2/ilyaz directory of CPAN, as
359 well as in my directory
360         ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
361
362 I include 3 extensions by Andread Kaiser, OS2::REXX, OS2::UPM, and OS2::FTP, 
363 into my ftp directory, mirrored on CPAN. I made
364 some minor changes needed to compile them by standard tools. I cannot 
365 test UPM and FTP, so I will appreciate your feedback. Other extensions
366 there are OS2::ExtAttribs, OS2::PrfDB for tied access to EAs and .INI
367 files - and maybe some other extensions at the time you read it.
368
369 Note that OS2 perl defines 2 pseudo-extension functions
370 OS2::Copy::copy and DynaLoader::mod2fname.
371
372 The -R switch of older perl is deprecated. If you need to call a REXX code
373 which needs access to variables, include the call into a REXX compartment
374 created by 
375         REXX_call {...block...};
376
377 Two new functions are supported by REXX code, 
378         REXX_eval 'string';
379         REXX_eval_with 'string', REXX_function_name => \&perl_sub_reference;
380
381 If you have some other extensions you want to share, send the code to
382 me.  At least two are available: tied access to EA's, and tied access
383 to system databases.
384
385 ==================================================================
386 ==                                                              ==
387 ==              User report [my comments in brackets, IZ]       ==
388 ==                                                              ==
389 ==      A web page: http://www.shadow.net/~troc/os2perl.html    ==
390 ==                                                              ==
391 ==================================================================
392
393 Starting in x:/usr/src, using 4OS2/32 2.5 as the command interpreter on
394 OS/2 2.30 with FixPak-17.  DAX is installed, but this shouldn't be a
395 factor.  Drive X is a TVFS virtual drive pointing to several physical
396 HPFS drives.
397
398 >>> Make sure that no copies or perl are currently running.  Miniperl
399     may fail during the build because it will find an older version
400     of perl.dll loaded in memory.
401
402         Close any running perl scripts.
403         Shut down anything that might run perl scripts, like cron.
404         `emxload -l` to check for loaded versions of perl.
405         `emxload -u perl.exe` to unload them.
406
407 >>> Pre-load some common utilities:
408
409         emxload -e sh.exe make.exe ls.exe tr.exe id.exe sed.exe
410         SET GCCLOAD=30   (number of minutes to hold the compiler)
411 [grep egrep fgrep cat rm uniq basename uniq sort - are not bad too.]
412     The theory is that it's faster to demand-load the development tools
413     from virtual memory than it is to re-load and re-link them all the
414     time.  This is definitely true with my system because swapfile.dat
415     is on a faster drive than my development environment.
416
417     ls, tr, and id represent the GNU file, text, and shell utilities.
418     These may not be needed, but it makes sure that their respective
419     DLLs are in memory.
420
421 >>> Unpack the perl 5_002_01 archive onto an HPFS partition.
422
423         tar vxzf perl5_002_01.tar-gz
424         cd perl5.002_01
425
426 [Do not forget to extract Configure as described above.]
427
428 >>> Read the README, keeping a copy open in another session for reference.
429
430         start /c /fg less os2/README
431
432 >>> Apply the OS/2 patches included with 5.002_01, as per the README.
433
434         for %m in (os2\diff.*) patch -p0 < %m
435         patch -p0 < os2\POSIX.mkfifo
436
437 [The patch below is already applied.]
438
439 >>> You may need to apply this patch if you plan to run a non-standard
440     Configure (that is, if you defy the README).  This patch will ensure
441     that Makefile inherits the libraries specified during Configure.
442     People running standard perl builds can probably ignore this patch.
443
444 *** os2\Makefile.SHs    Mon Mar 25 02:05:00 1996
445 --- os2\Makefile.SHs.new        Fri May 24 10:37:10 1996
446 ***************
447 *** 9,15 ****
448         emximp -o perl.imp perl5.def
449   
450   perl.dll: $(obj) perl5.def perl$(OBJ_EXT)
451 !       $(LD) $(LDDLFLAGS) -o $@ perl$(OBJ_EXT) $(obj) -lsocket perl5.def
452   
453   perl5.def: perl.linkexp
454         echo "LIBRARY 'Perl' INITINSTANCE TERMINSTANCE" > $@
455 --- 9,15 ----
456         emximp -o perl.imp perl5.def
457   
458   perl.dll: $(obj) perl5.def perl$(OBJ_EXT)
459 !       $(LD) $(LDDLFLAGS) -o $@ perl$(OBJ_EXT) $(obj) $(libs) perl5.def
460   
461   perl5.def: perl.linkexp
462         echo "LIBRARY 'Perl' INITINSTANCE TERMINSTANCE" > $@
463 ***************
464 *** 49,55 ****
465         cat perl.exports perl.map | sort | uniq -d | sed -e 's/\w\+/  "\0"/' > perl.linkexp
466   
467   perl.map: $(obj) perl$(OBJ_EXT) miniperlmain$(OBJ_EXT)
468 !       $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o dummy.exe miniperlmain$(OBJ_EXT) perl$(OBJ_EXT) $(obj) -lsocket -lm -Zmap -Zlinker /map
469         awk '{if ($$3 == "") print $$2}' <dummy.map | sort | uniq > perl.map
470         rm dummy.exe dummy.map
471   
472 --- 49,55 ----
473         cat perl.exports perl.map | sort | uniq -d | sed -e 's/\w\+/  "\0"/' > perl.linkexp
474   
475   perl.map: $(obj) perl$(OBJ_EXT) miniperlmain$(OBJ_EXT)
476 !       $(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o dummy.exe miniperlmain$(OBJ_EXT) perl$(OBJ_EXT) $(obj) $(libs) -Zmap -Zlinker /map
477         awk '{if ($$3 == "") print $$2}' <dummy.map | sort | uniq > perl.map
478         rm dummy.exe dummy.map
479
480 >>> Apply the patches from Ilya's perl5.002_01 binary distribution:
481
482         touch os2/dlfcn.h os2/dl_os2.c
483         patch -p1 < f:\perllib\README.fix1
484
485 >>> Run Configure.  Most people can run it by following the README:
486
487         sh Configure -des -D prefix=f:/usr/local
488
489     Advanced perl users (experienced C programmers, recommended) can run
490     the interactive Configure and answer the questions.  When in doubt
491     about an answer, check the EMX headers and documentation.  Pick the
492     default answer if that doesn't help:
493
494         sh Configure
495
496 [Yet more advanced users just specify the answers on the command line
497 of Configure, like I did with prefix.]
498
499     Note:  You may need to wrap an answer in quotes if it contains
500     spaces.  For example, "-lsocket -lm".
501
502     Note:  If you want to add some options to a long default, you can
503     use $* to include the default in your answer:  "$* -DDEBUGGING".
504
505     Configure warnings and errors, and possible work-arounds:
506
507         I don't know where 'ln' is....
508             (ignored; OS/2 doesn't have a ln command)
509
510         nm didn't seem to work right. Trying emxomfar instead...
511             (nothing to worry about)
512
513         The recommended value for $d_shrplib on this machine was "define"!
514             (kept the recommended value: y)
515
516         Directory f:/usr/lib/perl5/os2/5.00201/CORE doesn't exist.
517             (created the directory from another window with
518             \usr\bin\mkdir -p f:/usr/lib/perl5/os2/5.00201/CORE
519             and then answered: y.  Your directory may look different.)
520
521 [Ignore this as well, install script will create it for you.]
522
523         The recommended value for $i_dlfcn on this machine was "define"!
524             (kept the recommended value: y)
525
526         The recommended value for $d_fork on this machine was "undef"!
527             (kept the recommended value: y)
528
529         Figuring out the flag used by open() for non-blocking I/O...
530         Seems like we can use O_NONBLOCK.
531             This seems to be used for informative purposes only.
532             The errors that follow this (including a SIGPIPE) don't seem
533             to affect perl at all.  These were safely ignored.
534
535         What pager is used on your system? [/usr/ucb/more]
536             Had to answer "/usr/bin/less.exe" because Configure wants a
537             leading / (unix full path).  Need to edit config.sh later with
538             the real full path to the pager, including the drive letter.
539
540 [Apparently this setting is never used, so it is safe to ignore it.]
541
542         Hmm... F:/USR/BIN/sed: Unterminated `s' command
543             Perl built fine even with this error, so it seems safe to
544             ignore.
545
546     Things I did different from the defaults.  Most (if not all) of these
547     are optional changes.  They're listed here to show how good Configure
548     is at detecting the system setup.
549
550 [I add the options to put it on command line of Configure, see below.]
551
552         Selected 'none' for the man1 location.
553             (I prefer the pod2html version.)
554 [-D man1dir=none]
555         Selected 'none' for the man3 location.
556             (I prefer the pod2html version.)
557 [-D man3dir=none]
558         Changed the hostname and domain.
559             (I wanted to override a dynamic PPP address.  This only
560             matters if other people will be using your perl build.)
561 [-D myhostname=my_host_name -D mydomain=.foo.org]
562         Fixed the e-mail address.
563             (Put in a known working e-mail address.  This only matters
564             if other people will be using your perl build.)
565 [-D cf_email=root@myhostname.uucp]
566         Added some directories to the library search path.
567 [-D "libpth=f:/emx/lib/st f:/emx/lib"]
568         Added -g to the optimizer/debugger flags.
569 [-D optimize=-g]
570         Added "-lgdbm -ldb -lcrypt -lbsd" to the additional libraries.
571 [  -D "libs=-lsocket -lcrypt -lgdbm"
572   the rest of libraries will not be used]
573
574 >>> Advanced users may want to edit config.sh when prompted by Configure.
575     Most (all?) of these changes aren't really necessary:
576
577         d_getprior='define'
578         d_setprior='define'
579             (getpriority and setpriority are included in os2.c, but
580             Configure doesn't know to look there.)
581 [fixed already]
582         pager='f:/usr/bin/less.exe'
583             (Correcting Configure's insistence on a leading slash.)
584         bin_sh='f:/usr/bin/sh.exe'
585             (If Configure detects sh.exe somewhere else first.  Example:
586             it saw sh.exe at /bin/sh.exe on my TVFS drive, but I want
587             perl to look for it on the physical F drive.)
588         aout_ccflags='... existing flags... -DDEBUGGING'
589         aout_cppflags='... existing flags... -DDEBUGGING'
590             (If you want to include DEBUGGING for the aout version.)
591 [Do not do it, -D optimize=-g will automatically add these flags.]
592
593 >>> Allow Configure to make the build scripts.
594
595 >>> Allow Configure to run `make depend`.  Ignore the following warning:
596
597         perl.h:861: warning: `DEBUGGING_MSTATS' redefined
598 [corrected now]
599
600 >>> Rename any existing perl.dll, preventing anything from loading it and
601     saving a known working copy in case something goes wrong:
602
603         mv /usr/lib/perl.dll /usr/lib/ilya-perl.dll
604
605 >>> Run `make`, and ignore the following warnings:
606
607         perl.h:861: warning: `DEBUGGING_MSTATS' redefined
608 [corrected now]
609         invalid preprocessing directive name
610         emxomf warning: Cycle detected by make_type
611         LINK386 :  warning L4071: application type not specified; assuming WINDOWCOMPAT
612         Warning (will try anyway): No library found for -lposix
613         Warning (will try anyway): No library found for -lcposix
614         POSIX.c:203: warning: `mkfifo' redefined
615         POSIX.c:4603: warning: assignment makes pointer from integer without a cast
616
617 >>> If `make` dies while "Making DynaLoader (static)", you'll need to
618     put miniperl in the OS/2 paths.  This step is only necessary if `make`
619     can't find miniperl:
620 [I would be interested if somebody confirmes this.]
621
622         cp perl.dll /usr/lib        (where /usr/lib is in your LIBPATH)
623         cp miniperl.exe /usr/bin    (where /usr/bin is in your PATH)
624         make                        (ignore the errors in the previous step)
625
626         This should run to completion.
627
628 >>> Test the build:
629
630         make test
631
632     These tests fail:
633
634         io/fs..........FAILED on test 2
635
636             "OS/2 is not unix".  Test 2 checks the link() command, which
637             is not supported by OS/2.
638
639         io/pipe........f:/usr/bin/sh.exe: -c requires an argument
640         f:/usr/bin/sh.exe: -c requires an argument
641         The Unsupported function fork function is unimplemented at
642             io/pipe.t line 26.
643         FAILED on test 1
644
645             More "OS/2 is not unix" errors.  Read ahead to find out
646             why fork() fails.
647
648         op/exec........FAILED on test 4
649
650                 if (system "true") {print "not ok 4\n";} else \
651                 {print "ok 4\n";}
652
653             This fails for me, but changing it to read like this works:
654
655                 if (system '\usr\bin\true.cmd') {print "not ok 4\n";} \
656                 else {print "ok 4\n";}
657
658             So you can count this as another "OS/2 is not unix".
659
660         op/fork........The Unsupported function fork function is \
661             unimplemented at op/fork.t line 8.
662         FAILED on test 1
663
664             The dynamically-loaded version of perl currently doesn't
665             support fork().  This is a known behavior of EMX.
666
667         op/magic.......
668         Process terminated by SIGINT
669         ok
670
671             The test passed even with the SIGINT message.  I don't
672             know why, but I won't argue.
673
674         op/stat........ls: /dev: No such file or directory
675         f:/usr/bin/sh.exe: ln: not found
676         ls: perl: No such file or directory
677         FAILED on test 3
678
679             "OS/2 is not unix".  We don't have the ln command.
680
681         lib/anydbm.....Bad free() ignored at lib/anydbm.t line 51.
682         Bad free() ignored at lib/anydbm.t line 51.
683         Bad free() ignored at lib/anydbm.t line 51.
684         Bad free() ignored during global destruction.
685         Bad free() ignored during global destruction.
686         Bad free() ignored during global destruction.
687         FAILED on test 2
688
689             Test 2 looks at the file permissions for a database.  "OS/2
690             is not unix" so the permissions aren't exactly what this test
691             expects.
692
693         lib/db-btree...Bad free() ignored at lib/db-btree.t line 109.
694         Bad free() ignored at lib/db-btree.t line 221.
695         Bad free() ignored at lib/db-btree.t line 337.
696         Bad free() ignored at lib/db-btree.t line 349.
697         Bad free() ignored at lib/db-btree.t line 349.
698         Bad free() ignored at lib/db-btree.t line 399.
699         Bad free() ignored at lib/db-btree.t line 400.
700         Bad free() ignored at lib/db-btree.t line 401.
701         FAILED on test 20
702
703             Another file permissions test fails.
704
705         lib/db-hash....Bad free() ignored at lib/db-hash.t line 101.
706         Bad free() ignored at lib/db-hash.t line 101.
707         Bad free() ignored at lib/db-hash.t line 101.
708         Bad free() ignored at lib/db-hash.t line 239.
709         Bad free() ignored at lib/db-hash.t line 239.
710         Bad free() ignored at lib/db-hash.t line 239.
711         Bad free() ignored at lib/db-hash.t line 253.
712         Bad free() ignored at lib/db-hash.t line 253.
713         Bad free() ignored at lib/db-hash.t line 253.
714         FAILED on test 16
715
716             Another file permissions test fails.
717
718         lib/db-recno...Bad free() ignored at lib/db-recno.t line 138.
719         Bad free() ignored at lib/db-recno.t line 138.
720         FAILED on test 18
721
722             Another file permissions test fails.
723
724         lib/gdbm.......FAILED on test 2
725
726             Another file permissions test fails.
727
728         lib/sdbm.......FAILED on test 2
729
730             Another file permissions test fails.
731
732         Failed 11/94 tests, 88.30% okay.
733
734             All of which are known differences with unix or documented
735             behaviors in EMX.  I re-run the test with Ilya's version,
736             and the same tests fail.  This new build is a success.
737 [Note that bad free() mentioned above are bugs in the Berkeley
738 DB. They just are more visible under OS/2 with perl free(), because of
739 "rigid" function name resolution. You may disable it by setting 
740 PERL_BADFREE environment variable to 0.
741         To get finer tests, cd to ./t and run 
742                 perl harness
743 ]
744
745     (Actually, Ilya's perl release fails an extra test because I don't
746     have sed in f:\emx.add.  This shows how important it is to configure
747     and build perl yourself instead of grabbing pre-built binaries.)
748 [Hmm, should not happen... There is no mentions of full_sed under ./t
749 directory...]
750
751 >>> Cross your fingers and install it:
752
753         make install
754
755     Warnings encountered and workarounds presented.:
756
757         WARNING: You've never run 'make test'!!!  (Installing anyway.)
758             (Lies!  All lies!  At least it still installs.)
759
760         WARNING: Can't find libperl*.dll* to install into \
761         f:/usr/lib/perl5/os2/5.00201/CORE.  (Installing other things anyway.)
762             (Safe to ignore.  The important one, libperl.lib, gets copied.)
763
764         Couldn't copy f:/usr/bin/perl5.00201.exe to f:/usr/bin/perl.exe: \
765         No such file or directory
766             cp /usr/bin/perl5.00201.exe /usr/bin/perl.exe
767
768         Couldn't copy f:/usr/bin/perl.exe to /usr/bin/perl.exe: No such \
769         file or directory
770             (I think this one is safe to ignore since the two directories
771             point to the same place.)
772
773 >>> Laugh maniacally because you just built and installed your own copy
774     of perl, with all the paths set "just so" and with whatever little
775     psychotic modifications you've always wanted but were afraid to add.
776
777 -----------------------------------------------------------------------------
778
779 Development tools and versions:
780
781         EMX 0.9b with emxfix04 applied.
782
783         `ls --version` reports: 'GNU file utilities 3.12'
784         `tr --version` reports: 'tr - GNU textutils 1.14'
785         `id --version` reports: 'id - GNU sh-utils 1.12'
786
787         `sed --version` reports: 'GNU sed version 2.05'
788         `awk --version` reports: 'Gnu Awk (gawk) 2.15, patchlevel 6'
789         `grep --version` reports an illegal option and: 'GNU grep version 2.0'
790                 (this includes egrep)
791
792         `sort --version` reports: 'sort - GNU textutils 1.14'
793         `uniq --version` reports: 'uniq - GNU textutils 1.14'
794         `find --version` reports: 'GNU find version 4.1'
795
796         KSH_VERSION='@(#)PD KSH v5.2.4 96/01/17'
797                 (Ilya's patched version.)
798
799         `make --version` reports: 'GNU Make version 3.74'
800                 (Ilya's patched version.)
801
802         `emxrev` reports:
803                 EMX : revision = 42
804                 EMXIO : revision = 40
805                 EMXLIBC : revision = 40
806                 EMXLIBCM : revision = 43
807                 EMXLIBCS : revision = 43
808                 EMXWRAP : revision = 40
809
810 -----------------------------------------------------------------------------
811
812 Rocco
813 <troc@shadow.net>
814