mGTK - SML bindings for gtk+
============================

Webpage:
    http://mgtk.sourceforge.net/

Authors:
    Ken Friis Larsen <ken@friislarsen.net> and Henning Niss <hniss@itu.dk>

Copyright (C) 2000-2004 by Ken Friis Larsen and Henning Niss.


CURRENT VERSION
---------------
The current version is 
    mgtk-pre-0.93

Previous versions include
    mgtk-pre-0.92 (released July 12, 2004).
    mgtk-pre-0.90 (released June, 2004).
    pink-chickens (or mgtk-beta-0.03)
    red-hens (or mgtk-beta-0.02)
    green-horses-and-blue-ducks (or mgtk-alpha-0.01)


ABOUT
-----

mGTK is an SML interface to the C-based graphical toolkit Gtk+ (the
Gimp Toolkit).  Gtk+ is available from the homepage:
    http://www.gtk.org

mGTK can currently be used with SML systems Moscow ML and MLton.

To subscribe to the mgtk-announce mailing list go to:
    http://lists.sourceforge.net/lists/listinfo/mgtk-announce



REQUIREMENTS
------------

mGTK should work on any platform supported by both Moscow ML or MLton,
and Gtk+. We develop and test mGTK on Linux machines (running Debian).
mGTK is known to run successfully on the following machines

*   Linux, X86, Debian Sarge
*   Windows, X86 (not in this pre-release)
*   Mac OS X (not in this pre-release)

If you have had any success running mGTK on some other platform,
please send us an email with a description of the machine.

The following versions of Moscow ML or MLton, and Gtk+ are required:

*   Moscow ML: Version 2.00 (or newer) compiled with dynlib
    support. Moscow ML is available from:
        http://www.dina.kvl.dk/~sestoft/mosml.html
or

*   MLton: Tested with version 20040227 and 20041109 from Debian. MLton
    is available from:
        http://mlton.org

and 

*   Gtk+: mGTK will only work with the 2.4.x series.  Check your Gtk+ 
    version with the command:
        pkg-config --modversion gtk+-2.0
    Gtk+ is available from:
        http://www.gtk.org/
        http://www.gimp.org/win32 (Windows version)


DOCUMENTATION
-------------

At this time there is no documentation for mGTK :-( However, it should
be possible to use the documentation for the C interface to Gtk+
(available at the Gtk+ homepage; see above).

Also, you can take a peek in the examples directory (remember to read
the README file there).


COPYRIGHT NOTICE for mGTK
-------------------------

mGTK - a SML interface to the graphical toolkit gtk+
Copyright (C) 2000-2004 Ken Friis Larsen and Henning Niss

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
USA