GToolKit version 0.9.0
======================
March 14, 1999

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.0 or later, but *not* GTK 1.3.x.
      You can find this on <ftp://ftp.gtk.org/pub/gtk/>.

      I have updated all classes to use the GTK 1.2 function names and
      this release includes a number of incompatible changes. Most of
      the general changes from GTK 1.0 to GTK 1.2 apply to GToolKit as
      well. If you want to use threads, make sure that your Objective-C
      runtime library has been configured with threads enabled.

    o the new Objective-C runtime library, which is distributed as
      part of gcc-2.8.x and 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/).
      I have included a precompiled version (without threads) of
      this runtime for Linux-2.0/ELF/i386/libc5 in this archive
      (misc/gcc-2.7.2-objc-runtime.tar.gz).

    o an implementation of the OpenStep Foundation API

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

      - Foundation Framework (part of OpenStep 4.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.5.5.tar.gz".
	GNUStep-Base also requires "gstep-make-0.5.5.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-0.8.0.tar.gz".
        (I recommend using this one.)

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


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