To use the MiNT library enclosed herein, you will need the MiNT
include files (see mntinc24.zoo). The MiNT include files should
be compatible with the "standard" gcc include files, but provide
some definitions that are true only if __MINT__ is defined. As
shipped, __MINT__ is always defined. If you would prefer to compile
with the "normal" gcc libraries most of the time, then the following
steps are necessary:

(1) Copy all the files in mntinc24.zoo into your include
    directory, overwriting the old include files where
    applicable.
(2) Comment out the definition of __MINT__ in the include file
    compiler.h.
(3) Rename the gnu.olb and gnu16.olb from this library to mint.olb
    and mint16.olb, respectively; and rename crt0.o and gcrt0.o to
    mcrt0.o and mgcrt0.o respectively.
(4) Use gcc's -mint flag to link with the MiNT library.


Personally, I use the MiNT libraries for everything (replacing the gcc
libraries entirely) since 99% of the functions also work under TOS,
and the 1% that don't are things like fork() and pipe() that one
wouldn't really expect to work in a single-tasking OS. However,
everyone seems to have their own preferences on this matter.

A couple of other points: the files that have names starting with 'b'
are compiled with the -mbaserel flag which is supported by Howard Chu's
version of gcc 2.2.2.

Also: you may notice that there's no termcap.olb or termcap16.olb. That's
to save space; the files in the termcap library are already in the curses
library, so you can simply copy (or better yet, make a symbolic link from)
curses.olb to termcap.olb, bcurses.olb to btermcap.olb, etc.

There are no docs; I recommend getting the source code (see mntlib24.zoo)
and using that. The documentation for the gcc library applies to a
lot of this library, too, so you could get that; and a good book on
Unix and ANSI C programming would help a lot, since the library is mostly
ANSI and Posix compatible.

The library is based on the gcc library that Jwahar Bammi and I put together.
Lots of people have contributed to it, including (but not limited to):

Adrian Ashley, Jwahar Bammi, Scott Bigham, Kai-Uwe Bloem, Howard Chu,
John R. Dunning, Doug Gwyn, Dave Gymer, Michael Hohmuth, Alan Hourihane,
Alex Kiernan, Ulf Moeller, Allan Pratt, Arnold D. Robbins, Edgar Roeder,
Rich Salz, Dale Schumacher, Eric Smith, Henry Spencer, and Stephen Usher.

I've hacked on things quite a bit, so if they're broken don't blame the
original authors, blame me.

Eric R. Smith
eric.smith@uwo.ca
