

This version, 0.4, of Perl/Gtk is primarily for testing against gtk+1.1.2
and glib 1.1.3: please don't rely on it. It's does make a good sample of
things to come, but unfortunately it also seems to include a fine selection
of truly evil bugs.

If you are interested in Gnome modules, please look at Perl/Gnome 0.3000,
which goes with Gnome .30.


	The source files in this distribution are 
	Copyright (C) 1997-1998, Kenneth Albanowski, and are licensed for
	use under the same terms as Perl itself.

The graphics files, testgtkrc file, config/pkg-gtk.defs (originally
gtk.defs) file, and the origination for test.pl and simple.pl are from the
gtk distribution, and are under this copyright:

/* GTK - The GIMP Toolkit
 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Library General Public
 * License as published by the Free Software Foundation; either
 * version 2 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
 * Library General Public License for more details.
 *
 * You should have received a copy of the GNU Library General Public
 * License along with this library; if not, write to the Free
 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

The GNU public license is included with Perl, and with this distribution in
the file "COPYING".


Usage information: this package was designed around gtk 1.0.5, and 1.1.1,
and there is no guarantee it will work with any other distributions, or
indeed even those ones. To build, fully build and install Gtk in your system
(and glib too, if necessary), then run 'perl Makefile.PL', and 'make test',
and then 'make install' if all went well.

You may optionally run Makefile.PL with the --with-gdkimlib, --with-gtktty,
--with-gnome, --with-gtkglarea and/or --with-gtkxmhtml switches to enable
use of some Gtk widgets and Gdk functions available in those packages.

Gtk is available at <ftp://ftp.gimp.org/pub/gtk/>.

The code may very well still have leaks, and a few portions are incomplete
(such as Gdk colormap manipulation) and much of it is untested. No
documentation currently exists, but this code is designed to mimic the C
calling sequences as much as is reasonable.

A major file reorganization happened with 0.1.13, hopefully making the
module easier to work with, and add widgets to, but it may turn out to break
with older Perl installations. A configuration reorgnization occured after
0.3, to try and copy with supporting multiple Gtk versions. 0.4 introduced a new
fixup layer that might just break everything all over again. :-(

If you have been using Gtk-0.1.8, several changes have been made to the API,
including the change of enumeration and flag values to lowercase (to match
the constants defined in gtk.defs), and the requirement for Gtk->init() to
be invoked before any other Gtk functions.

Please bring information regarding bugs and other issues to
<gtk-list@redhat.com> (before posting, you will need to subscribe to the
list by sending 'subscribe' to gtk-list-request@redhat.com) or the author,
at <kjahds@kjahds.com>. I cannot guarantee, at the moment, that any
particular problem will be fixed.

Good Luck,
Ken
