summaryrefslogtreecommitdiff
path: root/os2/Changes
blob: 127a7e272a0127ddd7c9a2631aa7c0391fc7ad83 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
after 5.003_05:
	PERLLIB_PREFIX was not active if it matches an element of @INC
		as a whole.
	Do not need PERL_SBRK if crtdll-revision is >= 50.
	Use -Zsmall-conv if crtdll-revision is >= 50 (in static perl!).
:7: warning: #warning <dirent.h> requires <sys/types.h>
	We compile miniperl static. It cannot fork, thus there may be
		problems with pipes (since HAS_FORK is in
		place). Pipes are required by makemaker.
	We compile perl___.exe A.OUT and dynamic. It should be able to
		fork.
	If we can fork, we my_popen by popen unless "-|". Thus we
		write a cooky "-1" into the pid array to indicate
		this.
	Apparently we can fork, and we can load dynamic extensions
		now, though probably not simultaneously.
	*DB tests corrected for OS/2 one-user stat[2].
	/bin/sh is intercepted and replaced by SH_PATH.
	Note that having '\\' in the command line of one-arg `system'
		would trigger call via shell.
	Segfault with system {'ls'} 'blah'; corrected.
	Documentation of OS/2-different features added to main PODs.
	New buitins in Cwd::

		Cwd::current_drive
		Cwd::sys_chdir		- leaves drive as it is.
		Cwd::change_drive
		Cwd::sys_is_absolute	- has drive letter and is_rooted
		Cwd::sys_is_rooted	- has leading [/\\] (maybe
					  after a drive)
		Cwd::sys_is_relative	- changes with current dir
		Cwd::sys_cwd		- Interface to cwd from EMX.
		Cwd::sys_abspath(name, dir)	
					- Really really odious
					  function. Returns absolute
					  name of file which would 
					  have 'name' if CWD were 'dir'.
					Dir defaults to the current dir.
		Cwd::extLibpath [type]	- Get/set current value of extended
		Cwd::extLibpath_set	- library search path.
			path [type]
					The optional last argument redirects
					   to END-path if true,
					   default is to search BEGIN-path.
		(Note that some of these may be moved to different
		  libraries - eventually).
	Executables: 
		perl - can fork, can dynalink (but not simultaneously)
		perl_ - can fork, cannot dynalink
		perl__ - same as perl___, but PM.
		perl___ - cannot fork, can dynalink.
	The build of the first one - perl - is rather convoluted, and
	  requires a build of miniperl_.

after 5.003_07:
	custom tmpfile and tmpname which may use $TMP, $TEMP.
	all the calls to OS/2 API wrapped so that it is safe to use
		them under DOS (may die(), though).
	Tested that popen works under DOS with modified PDKSH and RSX.
	File::Copy works under DOS.
	MakeMaker modified to work under DOS (perlmain.c.tmp and sh -c true).

after 5.003_08:
	OS2::PrfDB exports symbols as documented;
	should work on OS/2 2.1 again.
	uses reliable signals when spawing.
	do not use popen() any more - no intermediate shell unless needed.

after 5.003_11:
	Functions emx_{malloc,realloc,calloc,free} are exported from DLL.
	get_sysinfo() bugs corrected (flags were not used and wrongly defined).

after 5.003_20:
	_isterm is substituted instead of isatty, s?random instead of srand.
	`register' disabled if -DDEBUGGING and not AOUT build: stupid SD386.
	3-argument select() was stomping over memory.

after 5.003_21:
	Can start scripts by executing 'dir/script' and
	'script.sh'. Form without extension will call shell only if
	the specified file exists (will not look on path) (to prohibit
	trying to run shell commands directly). - Needed by magic.t.

after 5.003_27:
	ALTERNATE_SHEBANG="extproc " supported, thus options on this
	line are processed (possibly twice). -S is made legal on such
	a line. This -S -x is not needed any more.
	perl.dll may be used from non-EMX programs (via PERL_SYS_INIT
	- the caller should have valid variable "env" with
	environment). Known problems: $$ does not work - is 0, waitpid
	returns immediately, thus Perl cannot wait for completion of
	started programs.

after 5.004_01:
	flock emulation added (disable by setting env PERL_USE_FLOCK=0),
		thanks to Rocco Caputo;
	RSX bug with missing waitpid circumvented;
	-S bug with full path with \ corrected.

before 5.004_02:
	-S switch to perl enables a search with additional extensions 
	.cmd, .btm, .bat, .pl as well.  This means that if you have
	mycmd.pl or mycmd.bat on PATH, 
		perl -S mycmd
	will work.  Perl will also look in the current directory first.
	Moreover, a bug with \; in PATH being non-separator is fixed.

after 5.004_03:
	$^E tracks calls to CRT now.  (May break if Perl masks some
	changes to errno?)
	$0 may be edited to longer lengths (at least under OS/2).
	OS2::REXX->loads looks in the OS/2-ish fashion too.

after 5.004_04:
	Default perl.exe was built with a shorter stack than expected.
	Strip extensions DLLs too (unless debugging build).
	./os2.c being RO could stop cp.
	When starting scripts, Perl will find them on path (using the same
	  extensions as for -S command-line switch).  If it finds magic
	  `extproc ' or `#!' cookies, it will start the scripts directly.
	May use `cmd /c more <' as a pager.
	If a program could not be started, this might have been hidden.
	End of pipe was closed twice when `open'ing a pipeline.

after 5.004_53:
	Minimal thread support added.  One needs to manually move pthread.h

after 5.004_64:
	Make DLL names different if thread-enabled.
	Emit more informative internal DLL descriptions.

5.004_72:
	Updated OS2::Process (v0.2) included.
	
after 5.004_73:
	Fixed a bug with argv not NULL-terminated when starting scripts.
	Support all the forms of starting scripts.
	Support killing a child when receiving a signal during system()
	(in two stage, on first send the same signal, on the next
	send SIGKILL).
	Add the same logic for scripts as in pdksh, including 
		stripping the path from #! line if needed, 
		calling EXECSHELL or COMSPEC for magic-less scripts;
	Now pdksh is called only if one-arg system()/friends contains
	metachars, or if magic-line asks for sh, or there is no magic
	line and EXECSHELL is set to sh.
	Shell is supplied the original command line if possible.

after 5.005_02:
	Can start PM programs from non-PM sessions by plain system()
		and friends.  Can start DOS/Win programs.  Can start
		fullscreen programs from non-fullscreen sessions too.
	In fact system(P_PM,...) was broken.
	We mangle the name of perl*.DLL, to allow coexistence of different
		versions of Perl executables on the system.  Mangling of
		names of extension DLL is also changed, thus running two
		different versions of the executable with loaded
		extensions should not lead to conflicts (since 
		extension-full-name and Perl-version mangling work in the 
		same set ot 576 possible keys, this may lead to clashes).
	$^E was reset on the second read, and contained ".\r\n" at the end.

after 5.005_53:
	Would segfault system()ing non-existing program;
	AOUT build was hosed;
	warning-test for getpriority() might lock the system hard on 
		pre-fixpak22 configuration (calling getpriority() on 
		non-existing process triggers a system-wide bug).


	PrfDB was using a bug in processing XSUBs returning U32.

	Variable $OS2::emx_rev implemented (string and numeric values
		are the same as C variables _emx_rev and _emx_vprt).
	Variable $OS2::emx_env implemented (same as C variable _emx_env).
	Variable $OS2::os_ver implemented (_osmajor + 0.001 * _osminor).

	Improved centralized management of HAB and HMQ.  To get Perl's
		HAB, call perl_hab_GET().  (After the initial call one
		can use Perl_hab instead.)  To require Perl's HMQ,
		call perl_hmq_GET(), to release it call perl_hmq_UNSET(),
		to obtain it between these calls use Perl_hmq.
	HMQ management is refcounted, and the program will morph
		itself into/from PM if required.
	If perl.h cannot be included, hab may be obtained by Perl_hab_GET().

	New function OS2::Error(do_harderror,do_exception).  Returns
		undef if it was not called yet, otherwise bit 1 is
		set if on previous call do_harderror was enabled, bit
		2 is set if if on previous call do_exception was enabled.
	This function enables/disables error popups associated with 
		hardware errors (Disk not ready etc.) and software exceptions.

	New function OS2::Errors2Drive(drive).  Returns undef if it was 
		not called yet, otherwise return false if Errors were
		not requested to be written to a hard drive, or the
		drive letter if this was requested.
	This function may redirect error popups associated with 
		hardware errors (Disk not ready etc.) and software exceptions
		to the file POPUPLOG.OS2 at the root directory of the
		specified drive.  Overrides OS2::Error() specified by 
		individual programs.  Given argument undef will
		disable redirection.  Has global effect, persists
		after the application exits.

	New function OS2::SysInfo().  Returns a hash with system information.
		The keys of the hash are

		MAX_PATH_LENGTH, MAX_TEXT_SESSIONS, MAX_PM_SESSIONS,
		MAX_VDM_SESSIONS, BOOT_DRIVE, DYN_PRI_VARIATION,
		MAX_WAIT, MIN_SLICE, MAX_SLICE, PAGE_SIZE,
		VERSION_MAJOR, VERSION_MINOR, VERSION_REVISION,
		MS_COUNT, TIME_LOW, TIME_HIGH, TOTPHYSMEM, TOTRESMEM,
		TOTAVAILMEM, MAXPRMEM, MAXSHMEM, TIMER_INTERVAL,
		MAX_COMP_LENGTH, FOREGROUND_FS_SESSION,
		FOREGROUND_PROCESS

	New function OS2::BootDrive(force).  Returns a letter without colon.

	New functions OS2::MorphPM(serve)/OS2::UnMorphPM(serve).  Transforms
		the current application into a PM application and back.
		The argument true means that a real message loop is
		going to be performed.
	OS2::MorphPM() returns the PM message queue handle as an integer.

	New function OS2::Serve_Messages(force).  Fake on-demand
		retrieval of outstanding PM messages.  If force is false,
		will not dispatch messages if a real message loop is known to
		be present.  Returns number of messages retrieved.
	Dies with "QUITing..." if WM_QUIT message is obtained.

	New function OS2::Process_Messages(force [, cnt]).  Retrieval
		of PM messages until window creation/destruction.  
		If force is false, will not dispatch messages 
		if a real message loop is known to be present.  
		Returns change in number of windows.  If cnt is given,
		it is incremented by the number of messages retrieved.
	Dies with "QUITing..." if WM_QUIT message is obtained.

after 5.005_54:
 	Opening pipes from/to processes could fail if (un)appropriate
 	combination of STDIN/STDOUT was closed.
 
 	If the only shell-metachars of a command are ' 2>&1' at the
 	end of a command, it is executed without calling the external shell.

after 5.005_57:
	Make UDP sockets return correct caller address (OS2 API bug);
	Enable TCPIPV4 defines (works with Warp 3 IAK too?!);
	Force Unix-domain sockets to start with "/socket", convert
	  '/' to '\' in the calls;
	Make C<system 1, $cmd> to treat $cmd as in C<system $cmd>;
	Autopatch Configure;
	Find name and location of g[nu]patch.exe;
	Autocopy perl????.dll to t/ when testing;

after 5.005_62:
	Extract a lightweight DLL access module OS2::DLL from OS2::REXX
	   which would not load REXX runtime system;
	Allow compile with os2.h which loads os2tk.h instead of os2emx.h;
	Put the version of EMX CRTL into -D define;
	Use _setsyserror() to store last error of OS/2 API for $^E;
	New macro PERL_SYS_INIT3(argvp, argcp, envp);
	Make Dynaloader return info on the failing module after failed dl_open();
	OS2::REXX test were done for interactive testing (were writing
	  "ok" to stderr);
	system() and friends return -1 on failure (was 0xFF00);
	Put the full name of executable into $^X
	  (alas, uppercased - but with /);
	t/io/fs.t was failing on HPFS386;
	Remove extra ';' from defines for MQ operations.

pre 5.6.1:
	Resolved: "Bad free()" messages (e.g., from DB_File) with -Zomf build.
	   The reason was: when an extension DLL was linked, the order of
	   libraries was similar to this:
		f1.obj f2.obj libperl.lib -llibr1 -llibr2
	   (with C RTL implicitly after this).  When libperl.lib overrides
	   some C RTL functions, they are correctly resolved when mentioned
	   in f1.obj and f2.obj.  However, the resolution for libr1.lib and
	   libr2.lib is implementation-dependent.

	   With -Zomf linking the symbols are resolved for libr1.lib and
	   libr2.lib *only if* they reside in .obj-file-sections of libperl.lib
	   which were already "picked up" for symbols in f1.obj f2.obj.
	   However, libperl.lib is an import library for a .DLL, so *each
	   symbol in libperl.lib sits in its own pseudo-section*!

	   Corollary: only those symbol from libperl.lib which were already
	   mentioned in f1.obj f2.obj would be used for libr1.lib and
	   libr2.lib.  Example: if f1.obj f2.obj do not mention calloc() but
	   libr1.lib and libr2.lib do, then .lib's will get calloc() of C RTL,
	   not one of libperl.lib.

	   Solution: create a small duplicate of libperl.lib with overriding
	   symbols only.  Put it *after* -llibr1 -llibr2 on the link line.
	   Map strdup() and putenv() to Perl_strdup() and Perl_putenv()
	   inside this library.

	Resolved: rmdir() and mkdir() do not accept trailing slashes.
	   Wrappers are implemented.
	Resolved: when loading modules, FP mask may be erroneously changed by
	   _DLLInitTerm() (e.g., TCP32IP).
		Solutions: a) dlopen() saves/restores the FP mask.
			   b) When starting, reset FP mask to a sane value
				(if the DLL was compile-time linked).
	New functions in package OS2:
		unsigned _control87(unsigned new,unsigned mask)	# as in EMX
		unsigned get_control87()
		# with default values good for handling exception mask:
		unsigned set_control87_em(new=MCW_EM,mask=MCW_EM)
	    Needed to guard against other situations when the FP mask is
	    stomped upon.  Apparently, IBM used a compiler (for some period
	    of time around '95?) which changes FP mask right and left...
	Resolved: $^X was always uppercased (cosmetic).  Solution:
	    use argv[0] if it differs from what the OS returns only in case.
	Resolved: when creating PM message queues, WinCancelShutdown() was
	    not called even if the application said that it would not serve
	    messages in this queue.  Could result in PM refusing to shutdown.

	    Solution: resolve WinCancelShutdown at run time, keep the refcount
	    of who is going to serve the queue.
	Resolved: Perl_Deregister_MQ() segfaulted (pid/tid not initialized).
	Resolved: FillWinError() would not fetch the error.
	    Solution: resolve WinGetLastError at run time, call it.
	Resolved: OS2::REXX would ignore arguments given to a Perl function
	    imported into the REXX compartment via REXX_eval_with().
	Resolved: OS2::REXX would treat arguments given to a Perl function
	    imported into the REXX compartment via _register() as ASCIIZ
	    strings inside of binary strings.
	Resolved: OS2::REXX did not document _register().
	Resolved: OS2::REXX would not report the error to REXX if an error
	    condition appeared during a call to Perl function from REXX
	    compartment.  As a result, the return string was not initialized.
	A complete example of a mini-application added to OS2::REXX.
	README.os2 updated to reflect the current state of Perl.

pre 5.7.2:
	aout build: kid bootstrap_* were not associated with XS.
	bldlevel did not contain enough info.
	extLibpath* was failing on the call of the second type.
	Configure defines flushNULL now (EMX -Zomf bug broke autodetection).
	Configure did not find SIGBREAK.
	extLibpath supports LIBSTRICT, better error detection.
	crypt() used if present in -lcrypt or -lufc.
	dumb getpw*(), getgr*() etc. supported; as in EMX, but if no
	    $ENV{PW_PASSWD}, the passwd field contains a string which
	    cannot be returned by crypt() (for security reasons).
	The unwound recursion in detecting executable by script was
	    using static buffers.  Thus system('pod2text') would fail if the
	    current directory contained an empty file named 'perl'.
	Put ordinals in the base DLL.
	Enable EXE-compression.
	    Load time (ms):  Without /e:2: 70.6; With /e:2: 75.3; Lxlite: 62.8
	    Size drops from 750K to 627K, with lxlite to 515K.
	    lxlite /c:max gives 488K, but dumps core in t/TEST
	os2ish.h defines SYSLOG constants ==> Sys::Syslog works.
	Corrected warnings related to OS/2 code.
	    At one place = was put instead of ==.
	Setting $^E should work.
	Force "SYS0dddd=0xbar: " to error messages and to dlerror().
	    ($^E == 2 printed SYS0002 itself, but 110 did not.)
	$OS2::nsyserror=0 switches off forcing SYSdddd on $^E.
	perl_.exe does not require PM dlls any more (symbols resolved at
	    runtime on the as needed basis).
	OS2::Process:
	    get/set: term size; codepages; screen's cursor; screen's contents
	    reliable session name setting;
	    process's parent pid, and the session id;
	    switching to and enumeration of sessions
	    window hierarchy inspection
	    post a message to a window
	More robust getpriority() on older Warps.

	New C APIs for runtime loading of entry points from DLLs
	(useful for entry points not present on older versions of
	OS/2, or with DLLs not present on floppy-boot stripped down
	setups): CallORD(), DeclFuncByORD(), DeclVoidFuncByORD(),
	DeclOSFuncByORD(), DeclWinFuncByORD(), AssignFuncPByORD().

pre 5.7.3:
	Testing with PERL_TEST_NOVREXX=1 in environment makes tests
	noninteractive (VREXX test requires pressing a button on a dialog).

	New (ugly and voodooish) hack to work around a bug in EMX
	runtime architecture:

	  EMX.DLL is *not* initialized from its _DLL_InitTerm()
	  routine, but the initialization is postponed until
	  immediately before main() is called by the principal
	  executable (may be the initialization also happens during
	  InitTerm of -Zso -Zsys DLLs?).  The only reason I can see is
	  to postpone the initialization until the "layout" structure
	  is available, so the type of the executable is known.
	  [Instead, one should have broken the initialization into two
	  steps, with no-layout-known initialization ASAP, and the
	  finishing touch done when "layout" is known.]

	  It is due to this hack that -Zsys, -Zso etc. are needed so
	  often.

	  If during initialization of the Perl runtime environment we
	  discover that EMX environment is not set up completely, this
	  can be because of either our DLL being called from an
	  uncompatible flavor of EMX executable, or from an
	  unrelated-to-EMX.DLL (e.g., -Zsys or compiled with a
	  different compiler) executable.  In the first case only the
	  CRTL is not completely initialized, in the other case
	  EMX.DLL may be not initialized too.

	  We detect which of these two situations takes place, then
	  explicitly call the initialization entry points of EMX.DLL
	  and of CRT.  The large caveat is that the init-entry point
	  of EMX.DLL also moves the stack pointer (another defect of
	  EMX architecture, the init() and
	  set_exception_handlers_on_stack() entry points should have
	  been separated).  Thus we need some inline-assembler to
	  compensate for this, and need to remove the installed
	  exception handler - it is useless anyway, since exception
	  handlers need to be on the stack.  [This one is on the
	  stack, but will be overwritten on exit from the function.]

	  We also install an extra hack to run our atexit() handlers
	  on termination of the process (since the principal
	  executable does not know about *this* CRTL, we need to do it
	  ourselves - and longjmp() out of the chain of exception
	  handlers at a proper moment :-().

	The net result: Perl DLL can be now used with an arbitrary
	application.  PERLREXX DLL is provided which makes Perl usable
	from any REXX-enabled application.

	New test targets added to test how well Perl DLL runs with
	different flavors of executables (see all_harness etc).  To
	avoid waiting for the user button press, run with env
	PERL_TEST_NOVREXX=1.

	Another hack: on init of Perl runtime environment, the
	executable is tested for being an aout EMX executable.  The
	test is the same done by gdb, so although this test is very
	voodoo, it should be pretty robust (the beginning of the
	executable code - at 0x10000 - is tested for a known bit
	pattern).  The result is used to set $OS2::can_fork, which is
	eventually used to set $Config::Config{can_fork}.

	REXX::eval_REXX() made reenterable.  ADDRESS PERLEVAL
	available for the run REXX code.  PERLLASTERROR available.

	A .map file is created for the .dll.  Now easier to debug the
	failures which do not happen with a debugging executable.

	Duplicate libperl.lib as perl.lib etc. to make Embed happier.

	File::Spec better adjusted to OS/2 (still does not support aa:/dir/).

	New module OS::Process::Const with necessary constants for the
	Perl calls which mimic OS/2 API calls.

After @14577:
	$Config{pager} better (but needs work in the binary installer!).

	New API: OS2::DLLname([type], [\&sub])

	New OS2::Process APIs:

		 process_hwnd winTitle_set winTitle swTitle_set bothTitle_set
                 hWindowPos hWindowPos_set DesktopWindow
                 ActiveWindow_set
                 EnableWindow EnableWindowUpdate IsWindowEnabled
                 IsWindowVisible IsWindowShowing WindowPtr WindowULong
                 WindowUShort SetWindowBits SetWindowPtr
                 SetWindowULong
                 SetWindowUShort MPFROMSHORT MPVOID MPFROMCHAR
                 MPFROM2SHORT
                 MPFROMSH2CH MPFROMLONG

	OS::Process::Const symbols exportable from OS::Process too.

	OS::Process: prototypes on subroutines which do not naturally
	take "vectors" as arguments (not backwards compatible!).

	New C API: SaveCroakWinError(), WinError_2_Perl_rc,
	DeclWinFuncByORD_CACHE(), DeclWinFuncByORD_CACHE_survive(),
	DeclWinFuncByORD_CACHE_resetError_survive(),
	DeclWinFunc_CACHE(), DeclWinFunc_CACHE_resetError(),
	DeclWinFunc_CACHE_survive(),
	DeclWinFunc_CACHE_resetError_survive(); many new OS2 entry
	points conveniently available via wrappers which will do the
	necessary run-time dynalinking.

After @15047:
	makes PerlIO preserve the binary/text mode of filehandles
	chosen by CRT library.  (However, TTY handles still are not
	clean, since switching them to TERMIO mode and back changes
	the NL translation law at runtime, and PerlIO level does not
	know this.)

After @18156:
	mkdir() rmdir() tolerate trailing slashes.
	"localized" morphing to PM when already morphed would unmorph at end.
	Convert \n to \r\n in REXX commands (Classic REXX would allow \r and
		\r\n, but not \n as line-ends).

After @19053:
	Better detection of OS/2 in Configure scripts (if c:/ is not readable).
	Better Configure support for \\ inside cpp-emited # lineno "filename".
	Export pthread-support functions from threaded DLL.
	[older change] If perl5.def file is present, the new perl5.def has
		compatible ordinals.
	OS/2 code compiles with threads enabled; much more robust pthreads
		emulation (but some statics still present); survives fork().
	New attributes supported with [f]stat() and chmod()
		  archived is 0x1000000 =  0100000000
		  hidden   is 0x2000000 =  0200000000
		  system   is 0x4000000 =  0400000000
		If extra flag 0x8000000 = 01000000000 is missing during
		chmod(), these 3 flags are ignored; this extra flag
		is set in the result of stat() [this provides backward
		compatibility, as well as transparency of stat()/
		chmod() supporting DOSISH].
	OS/2-specific modules use XSLoader now.
	Remove DLLs manually after failing build (link386 would not?!).
	Special-case stat()ing "/dev/nul" and "/dev/null" too.
	Update dlopen() and friends: preserve i387 flags, better error messages,
		support name==NULL (load for "this" DLL);
	OS2::DLL does not eval() generated functions, uses closes instead;
		new method wrapper_REXX() for DLL objects.

After @19774:
	Use common typemap for OS2:: modules.
	New test file os2/perlrexx.cmd (should be run manually; does not it
		exit too early???).
	Export fork_with_resources(), croak_with_os2error() from DLL.
	usleep() availability put in %Config{}.
	Combine most (but not all!) statics into one struct.
	New load-on-demand C functions 
		Dos32QueryHeaderInfo
		DosTmrQueryFreq
		DosTmrQueryTime
		WinQueryActiveDesktopPathname
		WinInvalidateRect
		WinCreateFrameControl
		WinQueryClipbrdFmtInfo
		WinQueryClipbrdOwner
		WinQueryClipbrdViewer
		WinQueryClipbrdData
		WinOpenClipbrd
		WinCloseClipbrd
		WinSetClipbrdData
		WinSetClipbrdOwner
		WinSetClipbrdViewer
		WinEnumClipbrdFmts 
		WinEmptyClipbrd
		WinAddAtom
		WinFindAtom
		WinDeleteAtom
		WinQueryAtomUsage
		WinQueryAtomName
		WinQueryAtomLength
		WinQuerySystemAtomTable
		WinCreateAtomTable
		WinDestroyAtomTable
		WinOpenWindowDC
		DevOpenDC
		DevQueryCaps
		DevCloseDC
		WinMessageBox
		WinMessageBox2
		WinQuerySysValue
		WinSetSysValue
		WinAlarm
		WinFlashWindow
		WinLoadPointer
		WinQuerySysPointer	
	Check "\\SEM32\\PMDRAG.SEM" before loading PM-specific DLLs.
	Handling of system {realname} was not correct in presence of
		exe-type deduction, #!-emulation etc.
	Use optimized PUSHTARG etc. XSUB convention.
	$^E stringification contains PMERR_INVALID_HWND, PMERR_INVALID_HMQ, 
		PMERR_CALL_FROM_WRONG_THREAD, PMERR_NO_MSG_QUEUE,
		PMERR_NOT_IN_A_PM_SESSION if these errors are not in .MSG file
		(at least on Warp3fp42).
	PERLLIB_PREFIX augmented by PERLLIB_582_PREFIX, PERLLIB_58_PREFIX,
		PERLLIB_5_PREFIX (example for 5.8.2, the first one present is
		considered).
	New flag bit 0x2 for OS2::MorphPM(): immediately unmorph after creation
		of message queue.
	(De)Registring MQ preserves i386 flags.
	When die()ing inside OS2:: API, include $^E in the message.
	New function OS2::Timer(): returns Tmr-timer ticks (about 1MHz) since
		start of OS/2, converted to number of seconds (keep in mind
		that this timer uses a different crystal than the real-time
		clock; thus these values have only weak relationship to the
		wall clock time; behaviour with APM on is not defined).
	New function OS2::DevCap() [XXX Wrong usage message!!!]
		Usage: OS2::DevCap([WHAT, [HOW=0]]); the default for WHAT is
		the memory device context, WHAT should be a device context
		(as integer) if HOW==0 and a window handle (as integer) if
		HOW==1.  Returns a hash with keys
			FAMILY IO_CAPS TECHNOLOGY DRIVER_VERSION WIDTH HEIGHT
			WIDTH_IN_CHARS HEIGHT_IN_CHARS HORIZONTAL_RESOLUTION
			VERTICAL_RESOLUTION CHAR_WIDTH CHAR_HEIGHT
			SMALL_CHAR_WIDTH SMALL_CHAR_HEIGHT COLORS COLOR_PLANES
			COLOR_BITCOUNT COLOR_TABLE_SUPPORT MOUSE_BUTTONS
			FOREGROUND_MIX_SUPPORT BACKGROUND_MIX_SUPPORT
			VIO_LOADABLE_FONTS WINDOW_BYTE_ALIGNMENT BITMAP_FORMATS
			RASTER_CAPS MARKER_HEIGHT MARKER_WIDTH DEVICE_FONTS
			GRAPHICS_SUBSET GRAPHICS_VERSION GRAPHICS_VECTOR_SUBSET
			DEVICE_WINDOWING ADDITIONAL_GRAPHICS PHYS_COLORS
			COLOR_INDEX GRAPHICS_CHAR_WIDTH GRAPHICS_CHAR_HEIGHT
			HORIZONTAL_FONT_RES VERTICAL_FONT_RES DEVICE_FONT_SIM
			LINEWIDTH_THICK DEVICE_POLYSET_POINTS
	New function OS2::SysValues(which = -1, hwndDesktop = HWND_DESKTOP).
		If which != -1, returns the corresponding SysValue.  Otherwise
		returns a hash with keys:
			SWAPBUTTON DBLCLKTIME CXDBLCLK CYDBLCLK
			CXSIZEBORDER CYSIZEBORDER ALARM 7 8 CURSORRATE
			FIRSTSCROLLRATE SCROLLRATE NUMBEREDLISTS WARNINGFREQ
			NOTEFREQ ERRORFREQ WARNINGDURATION NOTEDURATION
			ERRORDURATION 19 CXSCREEN CYSCREEN CXVSCROLL CYHSCROLL
			CYVSCROLLARROW CXHSCROLLARROW CXBORDER CYBORDER
			CXDLGFRAME CYDLGFRAME CYTITLEBAR CYVSLIDER CXHSLIDER
			CXMINMAXBUTTON CYMINMAXBUTTON CYMENU
			CXFULLSCREEN CYFULLSCREEN CXICON CYICON
			CXPOINTER CYPOINTER DEBUG CPOINTERBUTTONS POINTERLEVEL
			CURSORLEVEL TRACKRECTLEVEL CTIMERS MOUSEPRESENT
			CXALIGN CYALIGN
			DESKTOPWORKAREAYTOP DESKTOPWORKAREAYBOTTOM
			DESKTOPWORKAREAXRIGHT DESKTOPWORKAREAXLEFT 55
			NOTRESERVED EXTRAKEYBEEP SETLIGHTS INSERTMODE 60 61 62 63
			MENUROLLDOWNDELAY MENUROLLUPDELAY ALTMNEMONIC
			TASKLISTMOUSEACCESS CXICONTEXTWIDTH CICONTEXTLINES
			CHORDTIME CXCHORD CYCHORD CXMOTIONSTART CYMOTIONSTART
			BEGINDRAG ENDDRAG SINGLESELECT OPEN CONTEXTMENU CONTEXTHELP
			TEXTEDIT BEGINSELECT ENDSELECT BEGINDRAGKB ENDDRAGKB
			SELECTKB OPENKB CONTEXTMENUKB CONTEXTHELPKB TEXTEDITKB
			BEGINSELECTKB ENDSELECTKB ANIMATION ANIMATIONSPEED
			MONOICONS KBDALTERED PRINTSCREEN		/* 97, the last one on one of the DDK header */
			LOCKSTARTINPUT DYNAMICDRAG 100 101 102 103 104 105 106 107
	New function OS2::SysValues_set(which, val, hwndDesktop = HWND_DESKTOP).
	Support new keys NUMPROCESSORS MAXHPRMEM MAXHSHMEM MAXPROCESSES
		VIRTUALADDRESSLIMIT INT10ENABLE from OS2::SysInfo(); support
		up to 10 unnamed values after the last named one.
	New function OS2::SysInfoFor(id[,count=1]). [Wrong usage message!!!]
	New function OS2::Beep(freq = 440, ms = 100).
	New flags mod_name_C_function = 0x100, mod_name_HMODULE = 0x200 in
		addition to old mod_name_handle = 0, mod_name_shortname = 1,
		mod_name_full = 2 for OS2::DLLname(flag, cv); use an address
		(as integer) or module handle instead of cv.
	New function OS2::_headerInfo(req,size[,handle,[offset]]).
	New function OS2::libPath(); returns the value of LIBPATH.
	New function OS2::mytype(which=0) to query current process type:
		0:	type immediately after startup or last fork();
		1:	type immediately after startup;
		2:	type before the first morphing;
		3:	type as set now in the header.
	New function OS2::mytype_set(type);
	New function OS2::incrMaxFHandles(delta = 0); returns updated value
		for the possible number of open file descriptors.
	Make check_emx_runtime() thread-safe.
	Fix float-to-string conversion in the range .0001..0.1 (would return
		in exponential notation, per gcvt()).
	Make fork(): a) preserve i387 flags;
		     b) preserve the dynamically loaded (system) DLLs;
		     c) preserve morphed status;
	Make sleep() work with time > 0xffffffff/1000.
	Implement usleep() via _sleep2(); make select() with num_files==0
		thread-safe (via calling DosSleep()).
	OS2::Process::Const() manages (MB|MBID|CF|CFI|SPTR)_.* constants too.
	New (exported) functions from OS2::Process (some undocumented???):
		process_codepage_set
		TopLevel
		FocusWindow_set_keep_Zorder
		ActiveDesktopPathname
		InvalidateRect
		CreateFrameControl
		ClipbrdFmtInfo
		ClipbrdOwner
		ClipbrdViewer
		ClipbrdData
		OpenClipbrd
		CloseClipbrd
		ClipbrdData_set
		ClipbrdOwner_set
		ClipbrdViewer_set
		EnumClipbrdFmts
		EmptyClipbrd
		AddAtom
		FindAtom
		DeleteAtom
		AtomUsage
		AtomName
		AtomLength
		SystemAtomTable
		CreateAtomTable
		DestroyAtomTable
		_ClipbrdData_set
		ClipbrdText
		ClipbrdText_set
		_MessageBox
		MessageBox
		_MessageBox2
		MessageBox2
		LoadPointer
		SysPointer
		Alarm
		FlashWindow
	Do not use AUTOLOAD in OS2::DLL; moved to OS2::DLL::dll.
	New method OS2::DLL->module() (to replace botched ->new() method).
	New functions call20(), call20_p(), call20_rp3(), call20_rp3_p(),
		call20_Dos(), call20_Win(), call20_Win_0OK(),
		call20_Win_0OK_survive() in OS2::DLL to call C functions via
		pointers.

After @20218:
	select() workaround broke build of x2p.
	New OS2::Process (exported, undocumented) functions:
		kbdChar
		kbdhChar
		kbdStatus
		_kbdStatus_set
		kbdhStatus
		kbdhStatus_set
		vioConfig
		viohConfig
		vioMode
		viohMode
		viohMode_set
		_vioMode_set
		_vioState
		_vioState_set
		vioFont
		vioFont_set
	Make CheckOS2Error() macro return the error code.
	New dynaloaded entry point DosReplaceModule().
	New function OS2::replaceModule(target [, source [, backup]]).

After @21211:
	Make Cwd::sys_abspath() default to '.' and taint the result.
	Fix os2_process*.t to work if the default for VIO windows is maximized.
	Fix to avoid non-existing PIDs for get_sysinfo() broke pid==0.
	Restore default mode for pipes to be TEXT mode.

After @21379:
	New OS2::Process functions: __term_mirror_screen() __term_mirror()
		io_term().
	Fix a.out build: special-case thread::shared, pick up all the build
		static libraries, not only those for top-level modules.
	Fix DLLname() test to work with the static build too.
	New dynaloaded entry point RexxRegisterSubcomExe(); make OS2::REXX use
		it so it is not linked with REXX*.DLLs any more.
	If system "./foo", and empty "./foo" and "./foo.exe" exist,
		argv[0] would be set to junk.
	Make perl2cmd convert .pl files and keep the command-line switches.
	Make XSLoader and Perl-specific parts of DynaLoader to die with static
		builds (new variable $OS2::is_static used);
	Move perlmain.obj to the DLL; export main() as dll_perlmain(); create
		a library libperl_dllmain to translate the exported symbol
		back to main(); link the executables with this library instead
		of perlmain.obj.
	Add /li to link386's options (line number info in the .map file).
	Another break from fix to avoid non-existing PIDs for get_sysinfo().

After @21574:
	Update import libraries when perl version changes (e.g., due to rsync).
	New exported symbols dup() and dup2() [the wrappers have workaround
		for off-by-one error + double fault in the pre-Nov2003 kernels
		when a (wrong) filedescriptor which is limit+1 is dup()ed].
	Enable disabling fd via a FILE* (to avoid close() during fclose()).
	New dynaloaded entry point DosPerfSysCall().
	New function OS2::perfSysCall(cmd = CMD_KI_RDCNT, ulParm1= 0,
				      ulParm2= 0, ulParm3= 0); when called
		with cmd == CMD_KI_RDCNT = 0x63 and no other parameters,
		returns: in the scalar context: the tick count of processor 1;
			 in the list context: 4 tick counts per processor:
				total/idle/busy/interrupt-time.
		with cmd == CMD_KI_GETQTY == 0x41 and no other parameters,
		returns the CPU count.  Currently in other cases the return
		is void.
	New executables perl___<number> generated with decreased stack size
		(good when virtual memory is low; e.g. floppy boot).

After 5.8.2 (@21668):
	Fixes to installperl scripts to avoid junk output, allow overwrite
		of existing files (File::Copy::copy is mapped to DosCopy()
		with flags which would not overwrite).
	Disable DynaLoading of Perl modules with AOUT build (will core anyway).
	For AOUT build: Quick hack to construct directories necessary for
		/*/% stuff [maybe better do it from hints/os2.sh?].
	AOUT build: do -D__ST_MT_ERRNO__ to simplify linking with -Zmtd
		(e.g., to test GD: gd.dll linked with -Zmtd).
	MANIFEST.SKIP was read without a drive part of the filename.
	Rename Cwd::extLibpath*() to OS2::... (old names still preserved).
	Install perl.lib and perl.a too.
	New methods libPath_find(),has_f32(),handle(),fullname() for OS2::DLL.
	Enable quad support using long long.
	New C exported functions os2_execname(), async_mssleep(), msCounter(),
		InfoTable(), dir_subst(), Perl_OS2_handler_install(),
		fill_extLibpath().
	async_mssleep() uses some undocumented features which allow usage of
		highest possible resolution of sleep() while preserving low
		priority (raise of resolution may be not available before
		Warp3fp40; resolution is 8ms/CLOCK_SCALE).
		usleep() and select(undef,undef,undef,$t) are using this
		interface for time up to 0.5sec.
	New convenience macros os2win_croak_0OK(rc,msg), os2win_croak(rc,msg),
		os2cp_croak(rc,msg).
	Supports ~installprefix, ~exe, ~dll in PERLLIB_PREFIX etc (actual
		directories are substituted).
	New functions OS2::msCounter(), OS2::ms_sleep(), OS2::_InfoTable().
	Checks stack when fixing EMX being under-initialized (-Zomf -Zsys
		produces 32K stack???).
	New environment variables PERL_BEGINLIBPATH, PERL_PRE_BEGINLIBPATH,
		PERL_POST_BEGINLIBPATH, PERL_ENDLIBPATH, 
		PERL_PRE_ENDLIBPATH PERL_POST_ENDLIBPATH (~-enabled);
		PERL_EMXLOAD_SECS.
	Better handling of FIRST_MAKEFILE (propagate to subdirs during test,
		do not require Makefile.PL present).
	perl2cmd converter: do not rewrite if no change.
	README.os2 updated with info on building binary distributions and
		custom perl executables (but not much else).