EGCS 1.1.2 for Mingw32 -- Installation instructions
=========================================================

1. Get the distribution.

  a. For fast links, get the single zip file:

      - egcs-1.1.2-mingw32.zip

  b. For slower links, get the split files from "split" directory.

      - egcs-1.1.2-mingw32.zip.*

2. Pre-installation:

  a. Decide where to install it. I usually install in "C:\EGCS-1.1.2", but
     you can install *anywhere* you want, including on a ZIP/JAZ drive.
     All you have to do is to set PATH and optionally GCC_EXEC_PREFIX 
     accordingly (see later). From here on, I'll use "C:\EGCS-1.1.2" as 
     the installation root directory. Please replace with whatever you've 
     chosen. You can use the sample "MINGW32.BAT" I've provided in the 
     distribution to setup the variables.
  
  b. Make sure you DO NOT install on top of an existing installation.
     Either install elsewhere, or delete the old directory structure first.
  
4. INSTALL:
   
   You must use an "unzip" program that understands both long file names
   and also maintains directory structure. Pkunzip and WinZIP work just
   fine, and I'm sure a host of others do as well. You might have to
   supply "-d" option when unzipping to maintain directory structure.

   First create the installation directory. 

     C:\> mkdir C:\EGCS-1.1.2
     C:\> cd \EGCS-1.1.2

     C:\> unzip -d C:\tmp\egcs-1.1.2-mingw32.zip

   Note that if you retrieved the "split" files, then you will have to
   recombine them before you try to unzip. You can use the DOS COPY trick
   to recombine, or use the COMBINE.BAT in this directory.

5. Setting up environment variables and such:
   
   Starting from 1.1.1 release, EGCS, does not require *any* environment
   variable to run properly. You can still set GCC_EXEC_PREFIX if you
   wish (useful for example to switch between multiple GCC distributions), 
   but it's completely optional. EGCS now looks for the system includes, 
   libraries, programs, etc relative to its installation directory. There
   was an unfortunate bug in the egcs-1.1.1 release that only exposed
   itself under certain shells, but that's been fixed.

   You'll still need to add the EGCS-1.1.2 bin directory,
   C:\EGCS-1.1.2\bin, to your PATH for GCC to be able to find various 
   other tools such the linker, assembler, etc.

   The following is all you need for this release:
     
     C:\> PATH=C:\EGCS-1.1.2\BIN;%PATH%
    
   Again, see the supplied MINGW32.BAT file. Those of you who use a Unix
   like SHELL such as bash, use "mingw32.sh" instead. The supplied .BAT
   files does set the GCC_EXEC_PREFIX variable, but that's because I've
   forgotten to take it out before rolling the release.

   Make sure you do not have any other variables set from previous version
   or else GCC will search incorrect places for libraries and headers. The
   ones that you DO NOT need anymore are: LIBRARY_PATH, C_INCLUDE_PATH,
   CPLUS_INCLUDE_PATH, and OBJC_INCLUDE_PATH. If you *DO* have the variable
   GCC_EXEC_PREFIX in your environment, just make sure it's set correctly.

Good luck.

Links:

EGCS compiler    : http://www.cygnus.com/egcs/
My stuff         : http://www.xraylith.wisc.edu/~khan/software/gnu-win32/
Colin Peter      : http://www.fu.is.saga-u.ac.jp/~colin/gcc.html
    (USA Mirror) : http://www.geocities.com/Tokyo/Towers/6162/gcc.html
JJ VanderHeijden : http://agnes.dida.physik.uni-essen.de/~janjaap/mingw32/

Mumit Khan -- khan@xraylith.wisc.edu
http://www.xraylith.wisc.edu/~khan/

