This compiler is designed to be installed on top of emx 0.9d and will NOT
work with emx 0.9c. Also fix 04 for emx 0.9d is highly recommended.

This compiler (at least the C++ compiler) _WON'T_ work with binutils version
prior to 2.11.2. The latest binutils should be available from the same site
where you have downloaded this version of gcc.

If you do not trust the new version (or wish to use it for a test period
before trusting him) or for some reason want to keep both GCC 2.8.x and
the new compiler on your computer, the installation process was designed
to allow this.

To install it on temporary basis you should:

-*- Unzip all archives to the root directory on the same drive where emx is
    installed. The files will be unpacked into /emx/bin.new, /emx/include,
    /emx/dll and so on.

-*- Move the file /emx/bin.new/newgcc.cmd into /emx/bin; change it to suit all
    your needs, all instructions are inside newgcc.cmd.

-*- To switch to the new gcc just execute newgcc.cmd. To switch back exit from
    your shell.

To completely replace gcc 2.8.x with the new version you should merge all the
files from /emx/bin.new with the files in /emx/bin/*, overwriting any existing
files with the same name in /emx/bin. Then remove the bin.new subdirectory.
Also you may want to remove the old compilers called cc1.exe and cc1plus.exe
from the /emx/bin directory (the new compilers are under /emx/lib/gcc-lib/...).

Now the tricky part. Since EMX 0.9 has been written IBM added to OS/2 several
useful APIs, one of which is Unicode API. To allow usage of Unicode API in
EMX programs (and since programs linked libstdc++ will require it) I had to
write the missing API definitions (.h and import definitions). Now to add
the missing functions to os2.a and os2.lib (the libraries defining all OS/2
system-specific functions) you must go to /emx/lib and type 'make'. This will
re-build os2.a so that it contains all the functions defined in unicode.imp,
then will re-convert all outdated OMF libraries (.lib) from their a.out
counterparts (.a). Also you must go to the 
/emx/lib/gcc-lib/i386-pc-os2_emx/$(gcc-version)/ directory and type 'make'
as well for the same reason (to convert supplied a.out libraries into OMF
format in the case you will use the -Zomf switch). That's all.

Andrew Zabolotny, <zap@cobra.ru>
