The source files in this distribution are Copyright (C) 1997-1999, Kenneth Albanowski, Paolo Molaro and are licensed for use under the same terms as Perl itself. The graphics files, testgtkrc file, */*.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". Starting with version 0.7000 of this package, each submodule must be compiled separately: this allows for greater flexibility and lower memory usage. Gnome requires GdkImlib support build first. To compile each package, run "perl Makefile.PL; make; make install" in each subdir, starting from the base dir (the Gtk submodule, required by all the others). At the time of this writing the submodules supported are: ./ (Gtk), GdkImlib, Gnome, GtkXmHTML, GtkGLArea, Glade. See the INSTALL file for more details on installing this package. This setup may require changes in the source code of existing programs, ie if you need gdk-imlib support, you need to "use Gtk::Gdk::ImlibImage". The same applies if you used gnome features without "use Gnome". Also, starting with version 0.7000, info about flags and enumeration values are retreived directly from gtk+ at runtime instead of relying on our .defs files. This makes for faster startup and lower memory usage, but may introduce some source incompatibilities: the only one I know of is the values of Gtk::PackerOptions (pack-expand becomes expand now). This module should compile with Gtk+ version 1.2.x, gnome version 1.0.x, libglade version 0.11, gdkimlib version 1.9.x, gtkglarea 1.2.x. Some of the information below may be out of date. Usage information: this package was designed to work Gtk+ versions 0.99.10 through 1.2.3, though 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 several different switches to enable use of some Gtk widgets and Gdk functions available in those packages. These switches are listed when you run Makefile.PL. Gtk is available at . 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. 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 (before posting, you will need to subscribe to the list by sending 'subscribe' to gtk-list-request@redhat.com) or the primary author, at . I cannot guarantee, at the moment, that any particular problem will be fixed. Good Luck, Ken