NOTE: if you are compiling on mingw32 you MUST set 'CC=gcc' in the
      command-line arguments to 'make'!

For the impatient:

    make install-boot

(or

    make install-boot CC=gcc

if you are on a mingw32 host) will compile the bootstrap compiler from
precompiled '.c' files and install the binaries in /usr/local/.

For the rigorous:

    make

(or

    make CC=gcc

for mingw32) will perform a three-stage bootstrap of the compiler.
First the bootstrap compiler is compiled (from precompiled '.c' files,
as above) into the 'boot' directory.  The boot compiler then compiles
a new compiler, from original source, into the 'stage1' directory.
The stage1 compiler then compiles a new compiler, from original
source, into the 'stage2' directory -- in other words, 'stage2' will
ultimately contain a compiler compiled by a compiler that was itself
compiled locally from source.

    make install

will then install the stage2 compiler on your system under /usr/local.

Once installed, by either of the above methods, you should take a look
in the 'examples' directory.

If you'd like to install the files somewhere other than /usr/local,
set PREFIX to the (complete) name of the destination; e.g:

    PREFIX=/opt/lib/idc make

If you'd like to run the compiler out of the 'boot' or 'stage2'
directories, you can avoid having to specify the '-B' option to 'idc'
every time by setting IDC_LIBDIR in your environment, like this:

    IDC_LIBDIR=$HOME/idst5/stage2
    export IDC_LIBDIR

    ~/idst5/stage2/idc someFile.st

Have fun!
