GToolKit version 0.9.2
======================
January 17, 2000

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. (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 is similar in spirit to the GTKKit, which is (according
to the README) not actively developed at the moment. 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.
      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 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 OpenStep/MacOS 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 is "gstep-base-0.6.0.tar.gz".
	GNUstep-Base also requires "gstep-make-0.6.0.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-1999-11-03.tar.gz".

	WARNING: The 1999-11-03 snapshot seems to be broken and may not
	compile! You have to get the version from the CVS at the moment,
	you can find instructions on how to do this here:
	<http://www.geocities.com/SiliconValley/Monitor/7464/libFoundation/>

	You may get compilation errors due to some POSIX/glibc2 problems
	in libFoundation-0.8.0. Please read the file INSTALL for details.

    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.

      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 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.


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 Library General Public License.
See the file COPYING for copying conditions.

Elmar Ludwig <feludwig@informatik.Uni-Osnabrueck.DE>
