Parrot for OS/2 (aka Parrot/2)
                ------------------------------

Build Changes
-------------

To get parrot to build, hints/os2.pl was created. This sets the parrot build
environment settings to the needed values.

*Warning* Bash and Perl don't play nicely. As such, the perl path isn't
included in the environment variable. This means that perl.exe must be in your
path.


Build Requirements
------------------

You'll need a unix style build environment. Detailed instructions are available
on the web (eg http://www.os2world.com/os2files/xfree86/unix_environment_e.html)

Below are a list of packages you'll need (either these or later versions). They
should all be available on hobbes (hobbes.nmsu.edu):

bash-2_0-b264.zip
binutils-os2-2_9_1-bin.zip
bsddev.zip
cvs1107.zip
emxdev1.zip
emxdev2.zip
emxfix04.zip
emxrt.zip
gnuawk.zip
gnudev1.zip
gnudev2.zip
gnufutil.zip
gnugrep.zip
gnum4.zip
gnumake.zip
perl-5.6.1.zip

Install the above, and get them setup properly.


Library Dependencies
--------------------

You will also need part of the posix2 / ibext project stuff. Download
p2alpha3.zip from hobbes, or from their homepage (http://posix2.sourceforge.net)
Unpack it, go into posix2\libext\libc\unistdx and run make. This should build the
files, and create cExt.a and cExt.lib. Chuck these into \emx\lib before you start
trying to build parrot.

More information on porting to os/2 is available at
http://homepages.tu-darmstadt.de/~st002279/os2/porting.html


Building
--------

If your build environment is correctly set up, then simply pull the parrot source
from cvs and run "perl Configure.pl", "make test_prog.exe" and "make test" as perl
the main parrot readme.


About
-----

This document was written by Nick Burch <gagravarr@softhome.net> on 29/11/01, after
much prodding by Alex Gough. Its not a definative guide, as there are far better
ones about setting up build environments out there.