perl 5.003_03: [patch introduction and re-organisation]perl-5.003_03

# This is my patch perl5.003_03.pat to perl5.003_02
# The full description is below.
# Please execute the following commands before applying this patch.
# (You can feed this patch to 'sh' to do so.)
#  Andy Dougherty               <doughera@lafcol.lafayette.edu>

# Absorbed into Changes5.002
rm -f Changes.Conf

# Not needed.
rm -f ext/POSIX/mkposixman.pl

# Moved to README.os2.  I'm not sure why the README files are
# here rather than in the appropriate subdirectories.
rm -f os2/README

# Not needed.
rm -f pod/Makefile.PL

# New test for bit ops
touch t/op/bop.t

# Patches that create new tests don't always make them executable.
chmod +x t/*/*.t

# Create a new directory for Porting and Patching info.
mkdir Porting

exit 0

This is patch perl5.003_03.pat to perl version 5.003_02.
This takes you from 5.003_02 to 5.003_03.

To apply this patch, run the above commands,
cd to your perl source directory and then type

        patch -p1 -N < perl5.003_03.pat

The changes are described after each /^Index/ line below.  This is
designed so you can examine each change with a command such as

        csplit -k perl5.003_03.pat '/^Index:/' '{99}'

Patch and enjoy,

    Andy Dougherty              doughera@lafcol.lafayette.edu
    Dept. of Physics
    Lafayette College, Easton PA 18042

1 files changed, 0 insertions, 814 deletions

diff --git a/os2/README b/os2/README
deleted file mode 100644
index 785a6098bb..0000000000
--- a/os2/README
+++ /dev/null
@@ -1,814 +0,0 @@
-Contents:
-	Notes on the patch
-	IMPORTANT NOTE
-	Target
-	Binary Install
-	Reading the docs
-	Notes on build on OS/2
-	Compile summary
-	Tests which fail
-	Calls to external programs
-	OS/2 extensions
-	Report from the battlefield on 5.002_01
-
-Notes on the patch:
-~~~~~~~~~~~~~~~~~~~
-patches should be applied as
-	patch -p0 <.....
-All the diff.* files and POSIX.mkfifo should be applied.
-
-Additional files are available on
-	ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
-including patched pdksh and gnumake, needed for build.
-
-		   <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-IMPORTANT NOTE     <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-                   <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
-
-Note with the release 5.003_01 the dynamically loadable libraries
-should be rebuilt. In particular, DLLs are now created with the names
-which contain a checksum, thus allowing workaround for OS/2 scheme of
-caching DLLs.
-
-In particular, it is VERY IMPORTANT to have a correct perl.dll on
-LIBPATH during build, otherwise DLLs with wrong names will be
-created. Or have a perl.dll with the same naming convention for DLLs
-(hopefully, it should not change any time soon), or remove it from
-LIBPATH, add . to LIBPATH, wait until the build of DynaLoader fails,
-and then move the built DLL into LIBPATH.
-
-I also used this possibility to change perl linking type to -Zmt. It
-means that Perl now uses multithreaded CRTDLL, so your extensions can
-be multithreaded (note that the perl core is not thread-safe so far,
-so make sure you access Perl from one thread only). In particular, it
-is no longer needed to statically link X11_s.lib if you compile
-Perl/Tk/XFree.
-
-This newer port includes 
-	. numeric first argument to system(), see OS2::Process docs;
-	. modules OS2::Process, OS2::REXX, OS2::PrfDB, OS2::ExtAttrib.
-	. {get,set,end}*ent may work now (not checked)
-(most of this merged from ak's port).
-
-Note that static build of OS2::ExtAttrib fails some tests!
-
-Target:
-~~~~~~~
-
-This is not supposed to make a perfect Perl on OS/2. This patch is
-concerned only with perfect _build_ of Perl on OS/2. Some good
-features from Andreas Kaiser port missed this port. However, most of
-the features are available (possibly in different form). 
-
-!!! Note that [gs]etpriority functions in this port are compatible
-!!! with *nix, not with ak's port!!! 
-
-The priorities are absolute, go from 32 to -95, lower is quickier. 0
-is default,
-
-Binary Install:
-~~~~~~~~~~~~~~
-This version of perl allows binary installation on another site. There
-are two possibilities:
-	a) sh.exe is in the directory with the same name as on machine
-where perl was compiled (f:/bin here), and perl library is installed
-into the same directory as the built target (f:/perllib);
-	b) One of the above conditions is not true. Perl may be
-informed about location of sh.exe via PERL_SH_DRIVE or PERL_SH_DIR
-(see below). To relocate the perl library, one can
-	b1) either use the usual PERLLIB environment variable - but
-you should deduce yourself which components should be put there, say,
-by doing 
-		perl -de 0
-		x \@INC
-		q
-in the directory of the perl library. Another problem with this is
-that a module is missing, then perl will try to scan the builtin
-directories nevertheless. If perl was intended to be installed on
-f:/perllib, but your f: is a CDROM, then you may have some trouble.
-	b2) Best: binary edit perl.dll and perl_.exe (using perl
-itself as a binary editor) to fix the paths. Note that the new paths
-should be better no longer than the old.
-	b3) More convinient: set PERLLIB_PREFIX environment
-variable. It should contain two components, separated by whitespace
-and/or semicolon `;'. The first component is translated to the second
-one if it is 
-	     a prefix of 
-			 a component of
-				        Perl library lookup path.
-Say, if you install perllibrary into c:/lib/perl/ instead of
-f:/perllib/, set it to
-	set PERLLIB_PREFIX=f:/perllib/;c:/lib/perl/
-
-Reading the docs:
-~~~~~~~~~~~~~~~~
-If your `man' is correctly installed, you should just add
-x:/perllib/man directory to the end of MANPATH like this:
-	set MANPATH=c:/man;f:/perllib/man
-After this you can access the docs like this:
-	man perlfunc
-	man 3 less
-	man ExtUtils.MakeMaker
-Note that dot is used as package separator for package documentation,
-and as usual, sometimes you need to give the section - 3 above - to
-avoid shadowing by the less(1) manpage.
-
-Alternatively, you can build HTML docs by running
-	pod2html
-in x:/perllib/lib/pod directory.
-
-Alternatively, you can build IPF source by running
-	pod2ipf > perl.ipf
-in x:/perllib/lib/pod directory, and build (excellent! - best of perl
-docs available!) .INF documentation by running
-	ipfc /inf perl.ipf
-Move it on your BOOKSHELF path, and now you may inspect docs by
-	view perl
-or
-	view perl keyword_to_see
-
-Alternatively you may pick up precompiled HTML and .INF docs from the
-net, as usual, .INF is available on CPAN/.../os2/ilyaz.
-
-There are also _very_ good docs in TexInfo and Adobe PDF format.
-
-Notes on build on OS/2:
-~~~~~~~~~~~~~~~~~~~~~~~
-a) Make sure your sort is not the broken OS/2 one, and that you have /tmp
-on the build partition. Make sure that your pdksh.exe, make.exe and
-db.lib are OK (look elsewhere in this file).
-
-b) when extracting perl5.*.tar.gz you need to extract perl5.*/Configure
-separately, since by default perl5.001m/configure may overwrite it;
-	like this:
-		tar vzxf perl5.004.tar.gz --case-sensitive perl5.004/Configure
-or
-		tar --case-sensitive -vzxf perl5.004.tar.gz perl5.004/Configure
-
-c) Necessary manual intervention when compiling on OS/2:
-
-	Need to put perl.dll on LIBPATH after it is created.
-
-d) Compile summary:
-   ~~~~~~~~~~~~~~~
-!!! At the end of this README is independent description of the build
-!!! process by Rocco Caputo.
-
-# Look for hints/os2.sh and correct what is different on your system
-# I have rather spartan configuration.
-
-	# Prefix means where to install:
-sh Configure -des -D prefix=f:/perl5.005
-	# Note that you need to have /tmp/ ready.
-	#
-	# Ignore the message about missing `ln', and about `c' option
-	# to tr.
-make
-	# Will probably die after build of miniperl (unless you have DLL
-	# from previous compile). Need to move DLL where it belongs
-	#
-	# Somehow with 5.002b3 I needed to type another make after pod2man
-make
-	# some warnings in POSIX.c
-make test
-	# some tests fail, 9 or 10 on my system (see the list at end).
-	#
-	# before this you should create subdirs bin and lib in the 
-	# prefix directory (f:/perl5.005 above):
-	#
-	# To run finer tests, cd t && perl harness
-make install
-
-e) At the end of July 1996 GNU make was too buggy for compile.
-The maintainer has the patch (for a year now) that make it possible to
-compile perl. The binaries are included in
-	ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
-patches are available too.
-
-Note that the pdksh5.2.7 or later is required.
-
-!!!!!!!!!!!!!!!!!
-If you see that some '/' became '\' in pdksh, you use an old pdksh!
-Same with segfaults in Make 3.76 (?) - use my patched verions.
-!!!!!!!!!!!!!!!!!
-
-f) As distributed the DB library db.a-db.lib is not suitable for
-linking with -Zmt. A recompiled version must be available from my FTP
-site in os2/db_mt.zip.
-
-!!!!!!!!!!!!!!!!
-If you see: 
-	'errno' - unresolved external
-it means you use a wrong db.lib.
-!!!!!!!!!!!!!!!!
-
-Problems reported: 
-
-a) one of the latest tr is broken, get an old one :-(
-	1.11 works. (On compuserver?)
-b) You need a perlglob.exe and link386.
-c) Get rid of invalid perl.dll on your LIBPATH.
-
-
-Send comments to ilya@math.ohio-state.edu.
-
-======================================================
-Requires 0.9b (well, provision are made to make it build under 0.9a6,
-but they are not tested, please inform me on success).
-(earlier than 0.9b ttyname was not present, it is hard to maintain this
-difference automatically, though I try).
-======================================================
-
-Building with a.out style is supported by the `perl_' target of make.
-Dynamic extensions are not possible with perl_.exe, since boot code
-should return the retvalue on the Perl stack, the address of which is
-not known to the extension. Moreover: The build process for `perl_'
-DOES NOT KNOW about dependencies, so you should make sure that
-anything is up-to-date, say, by doing
-	make perl.dll
-first.
-
-The reason why compiling with a.out style executables leads to problems
-with dynamic extensions is:
-	a) OS/2 does not export symbols from executables;
-	b) Thus if extension needs to import symbols from an application
-		the symbols for the application should reside in a .dll.
-	c) You cannot export data from a .dll compiled with a.out style.
-On the other hand, aout-style compiled extension enjoys all the 
-(dis)advantages of fork().
-
-======================================================
-
-If you need to run PM code from perl, you may use PM mode executable
-perl__.exe. It is subject to restrictions specific to PM programs: it
-will close the VIO window the moment any PM call is performed.
-
-It is needed to run Perl/Tk (currently 7/96 - pre-alpha).
-
-======================================================
-
-The reason why the executables are named perl_.exe and perl__.exe is
-the following: Perl may parse #! lines in perl scripts to find out the
-additional switches to enable. Thus there is a convention `What is a
-perl executable - judging by name', and the above names conform to
-this convention.
-
-======================================================
-Tests which fail 
-~~~~~~~~~~~~~~~~
-with OMF compile (fork works - and all the related
-test - with A.OUT compile):
-
-io/fs.t: 2-5, 7-11, 18  as they should.
-io/pipe: all, since open("|-") is not working (works with perl_.exe).
-lib/"all the dbm".t: 1 test should fail (file permission).
-lib/io_pipe io_sock, as they should: use fork.
-op/fork all fail, as they should (except with perl_.exe)
-op/stat 3 20 35 as they should, 39 (-t on /dev/null) ???? Sometimes 4
-- timing problem ????
-
-Sometimes I have seen segfault in socket ????, only if run with Testing tools.
-
-A lot of `bad free'... in databases, bug in DB confirmed on other
-platforms. You may disable it by setting PERL_BADFREE environment variable
-to 0.
-
-Here is my result with OMF:
-
-Test         Status Wstat Total Fail Success  List of failed
-------------------------------------------------------------------------------
-io/fs.t                      22   10  45.45%  2-5, 7-11, 18
-io/pipe.t         1   256     8   ??       %  ??
-lib/anydbm.t                 12    1   8.33%  2
-lib/db-btree.t               86    1   1.16%  20
-lib/db-hash.t                43    1   2.33%  16
-lib/db-recno.t               35    1   2.86%  18
-lib/io_pipe.t     2   512     6   ??       %  ??
-lib/io_sock.t   255 65280     5   ??       %  ??
-lib/sdbm.t                   12    1   8.33%  2
-op/exec.t                     8    1  12.50%  5
-op/fork.t       255 65280     2   ??       %  ??
-op/stat.t                    56    4   7.14%  3, 20, 35, 39
-Failed 12/104 test scripts, 88.46% okay. 41/2224 subtests failed, 98.16% okay.
-
-and with A.OUT:
-
-Test         Status Wstat Total Fail  Failed  List of failed
-------------------------------------------------------------------------------
-io/fs.t                      22   10  45.45%  2-5, 7-11, 18
-lib/anydbm.t                 12    1   8.33%  2
-lib/db-btree.t               86    1   1.16%  20
-lib/db-hash.t                43    1   2.33%  16
-lib/db-recno.t               35    1   2.86%  18
-lib/sdbm.t                   12    1   8.33%  2
-op/exec.t                     8    1  12.50%  5
-op/stat.t                    56    4   7.14%  3, 20, 35, 39
-Failed 8/104 test scripts, 92.31% okay. 20/2224 subtests failed, 99.10% okay.
-
-Note that op/exec.5 fail because I do not have /bin/sh on this drive.
-
-With newer configs I could not reproduce most the crashes. However,
-after fixpak17 REXX variables acquire a trailing '\0' at end when go
-through the variable pool (even if they had one), thus making some
-REXX tests fail.
-
-=======================================================
-
-Calls to external programs:
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-Due to a popular demand the perl external program calling has been
-changed.  _If_ perl needs to call an external program _via shell_, the
-X:/bin/sh.exe will be called. The name of the shell is 
-overridable, as described below.
-
-Thus means that you need to pickup some copy of a sh.exe as well (I use one
-from pdksh). The drive X: above is set up automatically during the
-build, is settable in runtime from $ENV{PERL_SH_DRIVE}. Another way to
-change it is to set $ENV{PERL_SH_DIR} to be the directory in which
-sh.exe resides.
-
-Reasons: a consensus on perl5-porters was that perl should use one 
-non-overridable shell per platform. The obvious choices for OS/2 are cmd.exe
-and sh.exe. Having perl build itself would be impossible with cmd.exe as
-a shell, thus I picked up sh.exe. Thus assures almost 100% compatibility
-with the scripts coming from *nix.
-
-Disadvantages: sh.exe calls external programs via fork/exec, and there is
-_no_ functioning exec on OS/2. exec is emulated by EMX by asyncroneous call
-while the caller waits for child completion (to pretend that pid did
-not change). This means that 1 _extra_ copy of sh.exe is made active via
-fork/exec, which may lead to some resources taken from the system.
-
-The long-term solution proposed on p5-p is to have a directive
-	use OS2::Cmd;
-which will override system(), exec(), ``, and open(,'   |'). With current
-perl you may override only system(), readpipe() - the explicit version
-of ``, and maybe exec(). The code will substitute a one-argument system
-by CORE::system('cmd.exe', '/c', shift).
-
-If you have some working code for OS2::Cmd.pm, please send it to me,
-I will include it into distribution. I have no need for such a module, so
-cannot test it.
-
-===================================================
-
-OS/2 extensions
-~~~~~~~~~~~~~~~
-Since binaries cannot go into perl distribution, no extensions are
-included. They are available in .../os2/ilyaz directory of CPAN, as
-well as in my directory
-	ftp://ftp.math.ohio-state.edu/pub/users/ilya/os2
-
-I include 3 extensions by Andread Kaiser, OS2::REXX, OS2::UPM, and OS2::FTP, 
-into my ftp directory, mirrored on CPAN. I made
-some minor changes needed to compile them by standard tools. I cannot 
-test UPM and FTP, so I will appreciate your feedback. Other extensions
-there are OS2::ExtAttribs, OS2::PrfDB for tied access to EAs and .INI
-files - and maybe some other extensions at the time you read it.
-
-Note that OS2 perl defines 2 pseudo-extension functions
-OS2::Copy::copy and DynaLoader::mod2fname.
-
-The -R switch of older perl is deprecated. If you need to call a REXX code
-which needs access to variables, include the call into a REXX compartment
-created by 
-	REXX_call {...block...};
-
-Two new functions are supported by REXX code, 
-	REXX_eval 'string';
-	REXX_eval_with 'string', REXX_function_name => \&perl_sub_reference;
-
-If you have some other extensions you want to share, send the code to
-me.  At least two are available: tied access to EA's, and tied access
-to system databases.
-
-==================================================================
-==								==
-==		User report [my comments in brackets, IZ]	==
-==								==
-==	A web page: http://www.shadow.net/~troc/os2perl.html	==
-==								==
-==================================================================
-
-Starting in x:/usr/src, using 4OS2/32 2.5 as the command interpreter on
-OS/2 2.30 with FixPak-17.  DAX is installed, but this shouldn't be a
-factor.  Drive X is a TVFS virtual drive pointing to several physical
-HPFS drives.
-
->>> Make sure that no copies or perl are currently running.  Miniperl
-    may fail during the build because it will find an older version
-    of perl.dll loaded in memory.
-
-        Close any running perl scripts.
-        Shut down anything that might run perl scripts, like cron.
-        `emxload -l` to check for loaded versions of perl.
-        `emxload -u perl.exe` to unload them.
-
->>> Pre-load some common utilities:
-
-        emxload -e sh.exe make.exe ls.exe tr.exe id.exe sed.exe
-        SET GCCLOAD=30   (number of minutes to hold the compiler)
-[grep egrep fgrep cat rm uniq basename uniq sort - are not bad too.]
-    The theory is that it's faster to demand-load the development tools
-    from virtual memory than it is to re-load and re-link them all the
-    time.  This is definitely true with my system because swapfile.dat
-    is on a faster drive than my development environment.
-
-    ls, tr, and id represent the GNU file, text, and shell utilities.
-    These may not be needed, but it makes sure that their respective
-    DLLs are in memory.
-
->>> Unpack the perl 5_002_01 archive onto an HPFS partition.
-
-        tar vxzf perl5_002_01.tar-gz
-        cd perl5.002_01
-
-[Do not forget to extract Configure as described above.]
-
->>> Read the README, keeping a copy open in another session for reference.
-
-        start /c /fg less os2/README
-
->>> Apply the OS/2 patches included with 5.002_01, as per the README.
-
-        for %m in (os2\diff.*) patch -p0 < %m
-        patch -p0 < os2\POSIX.mkfifo
-
-[The patch below is already applied.]
-
->>> You may need to apply this patch if you plan to run a non-standard
-    Configure (that is, if you defy the README).  This patch will ensure
-    that Makefile inherits the libraries specified during Configure.
-    People running standard perl builds can probably ignore this patch.
-
-*** os2\Makefile.SHs	Mon Mar 25 02:05:00 1996
---- os2\Makefile.SHs.new	Fri May 24 10:37:10 1996
-***************
-*** 9,15 ****
-  	emximp -o perl.imp perl5.def
-  
-  perl.dll: $(obj) perl5.def perl$(OBJ_EXT)
-! 	$(LD) $(LDDLFLAGS) -o $@ perl$(OBJ_EXT) $(obj) -lsocket perl5.def
-  
-  perl5.def: perl.linkexp
-  	echo "LIBRARY 'Perl' INITINSTANCE TERMINSTANCE"	> $@
---- 9,15 ----
-  	emximp -o perl.imp perl5.def
-  
-  perl.dll: $(obj) perl5.def perl$(OBJ_EXT)
-! 	$(LD) $(LDDLFLAGS) -o $@ perl$(OBJ_EXT) $(obj) $(libs) perl5.def
-  
-  perl5.def: perl.linkexp
-  	echo "LIBRARY 'Perl' INITINSTANCE TERMINSTANCE"	> $@
-***************
-*** 49,55 ****
-  	cat perl.exports perl.map | sort | uniq -d | sed -e 's/\w\+/  "\0"/' > perl.linkexp
-  
-  perl.map: $(obj) perl$(OBJ_EXT) miniperlmain$(OBJ_EXT)
-! 	$(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o dummy.exe miniperlmain$(OBJ_EXT) perl$(OBJ_EXT) $(obj) -lsocket -lm -Zmap -Zlinker /map
-  	awk '{if ($$3 == "") print $$2}' <dummy.map | sort | uniq > perl.map
-  	rm dummy.exe dummy.map
-  
---- 49,55 ----
-  	cat perl.exports perl.map | sort | uniq -d | sed -e 's/\w\+/  "\0"/' > perl.linkexp
-  
-  perl.map: $(obj) perl$(OBJ_EXT) miniperlmain$(OBJ_EXT)
-! 	$(CC) $(LARGE) $(CLDFLAGS) $(CCDLFLAGS) -o dummy.exe miniperlmain$(OBJ_EXT) perl$(OBJ_EXT) $(obj) $(libs) -Zmap -Zlinker /map
-  	awk '{if ($$3 == "") print $$2}' <dummy.map | sort | uniq > perl.map
-  	rm dummy.exe dummy.map
-
->>> Apply the patches from Ilya's perl5.002_01 binary distribution:
-
-        touch os2/dlfcn.h os2/dl_os2.c
-        patch -p1 < f:\perllib\README.fix1
-
->>> Run Configure.  Most people can run it by following the README:
-
-        sh Configure -des -D prefix=f:/usr/local
-
-    Advanced perl users (experienced C programmers, recommended) can run
-    the interactive Configure and answer the questions.  When in doubt
-    about an answer, check the EMX headers and documentation.  Pick the
-    default answer if that doesn't help:
-
-        sh Configure
-
-[Yet more advanced users just specify the answers on the command line
-of Configure, like I did with prefix.]
-
-    Note:  You may need to wrap an answer in quotes if it contains
-    spaces.  For example, "-lsocket -lm".
-
-    Note:  If you want to add some options to a long default, you can
-    use $* to include the default in your answer:  "$* -DDEBUGGING".
-
-    Configure warnings and errors, and possible work-arounds:
-
-        I don't know where 'ln' is....
-            (ignored; OS/2 doesn't have a ln command)
-
-        nm didn't seem to work right. Trying emxomfar instead...
-            (nothing to worry about)
-
-        The recommended value for $d_shrplib on this machine was "define"!
-            (kept the recommended value: y)
-
-        Directory f:/usr/lib/perl5/os2/5.00201/CORE doesn't exist.
-            (created the directory from another window with
-            \usr\bin\mkdir -p f:/usr/lib/perl5/os2/5.00201/CORE
-            and then answered: y.  Your directory may look different.)
-
-[Ignore this as well, install script will create it for you.]
-
-        The recommended value for $i_dlfcn on this machine was "define"!
-            (kept the recommended value: y)
-
-        The recommended value for $d_fork on this machine was "undef"!
-            (kept the recommended value: y)
-
-        Figuring out the flag used by open() for non-blocking I/O...
-        Seems like we can use O_NONBLOCK.
-            This seems to be used for informative purposes only.
-            The errors that follow this (including a SIGPIPE) don't seem
-            to affect perl at all.  These were safely ignored.
-
-        What pager is used on your system? [/usr/ucb/more]
-            Had to answer "/usr/bin/less.exe" because Configure wants a
-            leading / (unix full path).  Need to edit config.sh later with
-            the real full path to the pager, including the drive letter.
-
-[Apparently this setting is never used, so it is safe to ignore it.]
-
-        Hmm... F:/USR/BIN/sed: Unterminated `s' command
-            Perl built fine even with this error, so it seems safe to
-            ignore.
-
-    Things I did different from the defaults.  Most (if not all) of these
-    are optional changes.  They're listed here to show how good Configure
-    is at detecting the system setup.
-
-[I add the options to put it on command line of Configure, see below.]
-
-        Selected 'none' for the man1 location.
-            (I prefer the pod2html version.)
-[-D man1dir=none]
-        Selected 'none' for the man3 location.
-            (I prefer the pod2html version.)
-[-D man3dir=none]
-        Changed the hostname and domain.
-            (I wanted to override a dynamic PPP address.  This only
-            matters if other people will be using your perl build.)
-[-D myhostname=my_host_name -D mydomain=.foo.org]
-        Fixed the e-mail address.
-            (Put in a known working e-mail address.  This only matters
-            if other people will be using your perl build.)
-[-D cf_email=root@myhostname.uucp]
-        Added some directories to the library search path.
-[-D "libpth=f:/emx/lib/st f:/emx/lib"]
-        Added -g to the optimizer/debugger flags.
-[-D optimize=-g]
-        Added "-lgdbm -ldb -lcrypt -lbsd" to the additional libraries.
-[  -D "libs=-lsocket -lcrypt -lgdbm"
-  the rest of libraries will not be used]
-
->>> Advanced users may want to edit config.sh when prompted by Configure.
-    Most (all?) of these changes aren't really necessary:
-
-        d_getprior='define'
-        d_setprior='define'
-            (getpriority and setpriority are included in os2.c, but
-            Configure doesn't know to look there.)
-[fixed already]
-        pager='f:/usr/bin/less.exe'
-            (Correcting Configure's insistence on a leading slash.)
-        bin_sh='f:/usr/bin/sh.exe'
-            (If Configure detects sh.exe somewhere else first.  Example:
-            it saw sh.exe at /bin/sh.exe on my TVFS drive, but I want
-            perl to look for it on the physical F drive.)
-        aout_ccflags='... existing flags... -DDEBUGGING'
-        aout_cppflags='... existing flags... -DDEBUGGING'
-            (If you want to include DEBUGGING for the aout version.)
-[Do not do it, -D optimize=-g will automatically add these flags.]
-
->>> Allow Configure to make the build scripts.
-
->>> Allow Configure to run `make depend`.  Ignore the following warning:
-
-        perl.h:861: warning: `DEBUGGING_MSTATS' redefined
-[corrected now]
-
->>> Rename any existing perl.dll, preventing anything from loading it and
-    saving a known working copy in case something goes wrong:
-
-        mv /usr/lib/perl.dll /usr/lib/ilya-perl.dll
-
->>> Run `make`, and ignore the following warnings:
-
-        perl.h:861: warning: `DEBUGGING_MSTATS' redefined
-[corrected now]
-        invalid preprocessing directive name
-        emxomf warning: Cycle detected by make_type
-        LINK386 :  warning L4071: application type not specified; assuming WINDOWCOMPAT
-        Warning (will try anyway): No library found for -lposix
-        Warning (will try anyway): No library found for -lcposix
-        POSIX.c:203: warning: `mkfifo' redefined
-        POSIX.c:4603: warning: assignment makes pointer from integer without a cast
-
->>> If `make` dies while "Making DynaLoader (static)", you'll need to
-    put miniperl in the OS/2 paths.  This step is only necessary if `make`
-    can't find miniperl:
-[I would be interested if somebody confirmes this.]
-
-        cp perl.dll /usr/lib        (where /usr/lib is in your LIBPATH)
-        cp miniperl.exe /usr/bin    (where /usr/bin is in your PATH)
-        make                        (ignore the errors in the previous step)
-
-        This should run to completion.
-
->>> Test the build:
-
-        make test
-
-    These tests fail:
-
-        io/fs..........FAILED on test 2
-
-            "OS/2 is not unix".  Test 2 checks the link() command, which
-            is not supported by OS/2.
-
-        io/pipe........f:/usr/bin/sh.exe: -c requires an argument
-        f:/usr/bin/sh.exe: -c requires an argument
-        The Unsupported function fork function is unimplemented at
-            io/pipe.t line 26.
-        FAILED on test 1
-
-            More "OS/2 is not unix" errors.  Read ahead to find out
-            why fork() fails.
-
-        op/exec........FAILED on test 4
-
-                if (system "true") {print "not ok 4\n";} else \
-                {print "ok 4\n";}
-
-            This fails for me, but changing it to read like this works:
-
-                if (system '\usr\bin\true.cmd') {print "not ok 4\n";} \
-                else {print "ok 4\n";}
-
-            So you can count this as another "OS/2 is not unix".
-
-        op/fork........The Unsupported function fork function is \
-            unimplemented at op/fork.t line 8.
-        FAILED on test 1
-
-            The dynamically-loaded version of perl currently doesn't
-            support fork().  This is a known behavior of EMX.
-
-        op/magic.......
-        Process terminated by SIGINT
-        ok
-
-            The test passed even with the SIGINT message.  I don't
-            know why, but I won't argue.
-
-        op/stat........ls: /dev: No such file or directory
-        f:/usr/bin/sh.exe: ln: not found
-        ls: perl: No such file or directory
-        FAILED on test 3
-
-            "OS/2 is not unix".  We don't have the ln command.
-
-        lib/anydbm.....Bad free() ignored at lib/anydbm.t line 51.
-        Bad free() ignored at lib/anydbm.t line 51.
-        Bad free() ignored at lib/anydbm.t line 51.
-        Bad free() ignored during global destruction.
-        Bad free() ignored during global destruction.
-        Bad free() ignored during global destruction.
-        FAILED on test 2
-
-            Test 2 looks at the file permissions for a database.  "OS/2
-            is not unix" so the permissions aren't exactly what this test
-            expects.
-
-        lib/db-btree...Bad free() ignored at lib/db-btree.t line 109.
-        Bad free() ignored at lib/db-btree.t line 221.
-        Bad free() ignored at lib/db-btree.t line 337.
-        Bad free() ignored at lib/db-btree.t line 349.
-        Bad free() ignored at lib/db-btree.t line 349.
-        Bad free() ignored at lib/db-btree.t line 399.
-        Bad free() ignored at lib/db-btree.t line 400.
-        Bad free() ignored at lib/db-btree.t line 401.
-        FAILED on test 20
-
-            Another file permissions test fails.
-
-        lib/db-hash....Bad free() ignored at lib/db-hash.t line 101.
-        Bad free() ignored at lib/db-hash.t line 101.
-        Bad free() ignored at lib/db-hash.t line 101.
-        Bad free() ignored at lib/db-hash.t line 239.
-        Bad free() ignored at lib/db-hash.t line 239.
-        Bad free() ignored at lib/db-hash.t line 239.
-        Bad free() ignored at lib/db-hash.t line 253.
-        Bad free() ignored at lib/db-hash.t line 253.
-        Bad free() ignored at lib/db-hash.t line 253.
-        FAILED on test 16
-
-            Another file permissions test fails.
-
-        lib/db-recno...Bad free() ignored at lib/db-recno.t line 138.
-        Bad free() ignored at lib/db-recno.t line 138.
-        FAILED on test 18
-
-            Another file permissions test fails.
-
-        lib/gdbm.......FAILED on test 2
-
-            Another file permissions test fails.
-
-        lib/sdbm.......FAILED on test 2
-
-            Another file permissions test fails.
-
-        Failed 11/94 tests, 88.30% okay.
-
-            All of which are known differences with unix or documented
-            behaviors in EMX.  I re-run the test with Ilya's version,
-            and the same tests fail.  This new build is a success.
-[Note that bad free() mentioned above are bugs in the Berkeley
-DB. They just are more visible under OS/2 with perl free(), because of
-"rigid" function name resolution. You may disable it by setting 
-PERL_BADFREE environment variable to 0.
-	To get finer tests, cd to ./t and run 
-		perl harness
-]
-
-    (Actually, Ilya's perl release fails an extra test because I don't
-    have sed in f:\emx.add.  This shows how important it is to configure
-    and build perl yourself instead of grabbing pre-built binaries.)
-[Hmm, should not happen... There is no mentions of full_sed under ./t
-directory...]
-
->>> Cross your fingers and install it:
-
-        make install
-
-    Warnings encountered and workarounds presented.:
-
-        WARNING: You've never run 'make test'!!!  (Installing anyway.)
-            (Lies!  All lies!  At least it still installs.)
-
-        WARNING: Can't find libperl*.dll* to install into \
-        f:/usr/lib/perl5/os2/5.00201/CORE.  (Installing other things anyway.)
-            (Safe to ignore.  The important one, libperl.lib, gets copied.)
-
-        Couldn't copy f:/usr/bin/perl5.00201.exe to f:/usr/bin/perl.exe: \
-        No such file or directory
-            cp /usr/bin/perl5.00201.exe /usr/bin/perl.exe
-
-        Couldn't copy f:/usr/bin/perl.exe to /usr/bin/perl.exe: No such \
-        file or directory
-            (I think this one is safe to ignore since the two directories
-            point to the same place.)
-
->>> Laugh maniacally because you just built and installed your own copy
-    of perl, with all the paths set "just so" and with whatever little
-    psychotic modifications you've always wanted but were afraid to add.
-
------------------------------------------------------------------------------
-
-Development tools and versions:
-
-        EMX 0.9b with emxfix04 applied.
-
-        `ls --version` reports: 'GNU file utilities 3.12'
-        `tr --version` reports: 'tr - GNU textutils 1.14'
-        `id --version` reports: 'id - GNU sh-utils 1.12'
-
-        `sed --version` reports: 'GNU sed version 2.05'
-        `awk --version` reports: 'Gnu Awk (gawk) 2.15, patchlevel 6'
-        `grep --version` reports an illegal option and: 'GNU grep version 2.0'
-                (this includes egrep)
-
-        `sort --version` reports: 'sort - GNU textutils 1.14'
-        `uniq --version` reports: 'uniq - GNU textutils 1.14'
-        `find --version` reports: 'GNU find version 4.1'
-
-        KSH_VERSION='@(#)PD KSH v5.2.4 96/01/17'
-                (Ilya's patched version.)
-
-        `make --version` reports: 'GNU Make version 3.74'
-                (Ilya's patched version.)
-
-        `emxrev` reports:
-                EMX : revision = 42
-                EMXIO : revision = 40
-                EMXLIBC : revision = 40
-                EMXLIBCM : revision = 43
-                EMXLIBCS : revision = 43
-                EMXWRAP : revision = 40
-
------------------------------------------------------------------------------
-
-Rocco
-<troc@shadow.net>
-