GToolKit version 0.8.4
======================
January 16, 1999

This is the second 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.0.6 or later (ftp://ftp.gtk.org/pub/gtk/)
      (Version 1.0.5 *may* still work but has not been tested.)

      If anyone would like to see GToolKit for the development
      series of GTK (1.1.x), please let me know.

    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.0.tar.gz".
	GNUStep-Base also requires "gstep-make-0.5.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-0.8.0.tar.gz".
        (I recommend using this one.)


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>
