GToolKit version 0.9.4
======================
January 4, 2001

This is the latest public release of GToolKit, an Objective-C interface
library to the GTK+ widget set. GTK+, which stands for the Gimp Toolkit,
is a library for creating graphical user interfaces for the X Window
System and MS Win32. (The file `NEWS' contains a list of recent changes.)

There are already a number of different Objective-C interface libraries
around and each one has its own features, so you have to decide for
yourself which one to try and use. This package uses NSObject as its
base class and requires a Foundation implementation. Almost all source
files are automatically generated from the GTK include files, so
upgrading to newer versions of GTK should not be a problem.

In order to compile and use the library, you must have some additional
software installed. You will need:

  o GTK+ version 1.2.6 or later, but *not* GTK+ 1.3.x or 2.0.x.
    You can find this on <ftp://ftp.gtk.org/pub/gtk/>.

    If you want to use threads, make sure that both your Objective-C
    runtime library and GTK+ have been configured with threads enabled.

  o the new Objective-C runtime library, which is distributed as part
    of gcc-2.8.x (and newer) and all recent versions of egcs (look for
    the include file objc/thr.h)

    There is also a patch for the gcc-2.7.2.x runtime available from
    the GNUstep ftp-server: <ftp://ftp.gnustep.org/pub/gnustep/patches/>.

  o an implementation of the OpenStep Foundation API

    Currently three implementations are available (as far as I know):

    - Foundation Framework (part of Mac OS X by Apple Computer Inc.)

    - GNUstep-base library (available from ftp.gnustep.org and mirrors)

      It can be found at <ftp://ftp.gnustep.org/pub/gnustep/core/>, the
      current version (at time of writing) is "gstep-base-0.6.6.tar.gz"
      (versions older than 0.6.6 may no longer work). GNUstep-base also
      requires "gstep-make-0.6.6.tar.gz".

    - libFoundation library (also available from ftp.gnustep.org)

      It can be found at <ftp://ftp.gnustep.org/pub/gnustep/contrib/>,
      the current version is "libFoundation-snap-2000-12-22.tgz".

      If you have trouble compiling a snapshot, try to get the version
      from the CVS. You can find instructions on how to do this here:
      <http://www.geocities.com/SiliconValley/Monitor/7464/libFoundation/>

  o the libglade and libxml libraries (this is optional)

    If configure detects libglade on your system, it will enable the new
    Glade support in GToolKit (Glade is a user interface builder for GTK).
    Any recent version of these libraries will do, but newer releases of
    libglade may require specific libxml versions.

    You can find the libraries here:
    <ftp://ftp.gnome.org/pub/GNOME/stable/sources/libglade/>
    <ftp://ftp.gnome.org/pub/GNOME/stable/sources/libxml/>
    (please use one of the numerous GNOME mirror sites)

Information about compiling and installing the library can be found in the
file INSTALL. You will have to change into the directory `GToolKit' before
running `make'. The `Examples' directory contains several test programs.
Note: You will have to install the library before you can compile any of
the test programs.

HTML documentation for the library can be found in the `html' directory.
Please send any bug reports, patches, suggestions or comments to my email
address given below.

The GToolKit home page on the World Wide Web:
    <http://www.inf.uos.de/elmar/projects/gtoolkit/>

The primary FTP address is now:
    <ftp://ftp.inf.uos.de/pub/elmar/gtk/objc-gtoolkit/>


Copyright (c) 1998, 1999, 2000  Elmar Ludwig.

This library is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License. See the file
COPYING.LIB for copying conditions.

Individual files (notably gtkgen and gtoolkit.m4) use the GNU General
Public License instead; see the file COPYING for the complete license.

Elmar Ludwig <elmar@informatik.uni-osnabrueck.de>
