Perl bindings to the 2.x series of the Gtk+ graphical user interface library. This module allows you to write graphical user interfaces in a Perlish and object-oriented way, freeing you from the casting and memory management in C, yet remaining very close in spirit to original API. Find out more about Gtk+ at http://www.gtk.org.
The GTK+ Reference Manual [ http://developer.gnome.org/doc/API/2.0/gtk/ ] is also a handy companion when writing Gtk programs in any language. The Perl bindings follow the C API very closely, and the C reference should be considered the canonical documentation.
Be sure to check out the example programs in the "examples" and "gtk-demo" directories.
To discuss gtk2-perl, ask questions and flame/praise the authors, join gtk-perl-list@gnome.org at lists.gnome.org.
Also have a look at the gtk2-perl website and sourceforge project page, http://gtk2-perl.sourceforge.net
To install this module type the following:
perl Makefile.PL
make
make test
make install
To avoid installing to a system directory, since this is a beta release, you can change the installation prefix at Makefile.PL time with
perl Makefile.PL PREFIX=/some/other/place
This will install the module to the subdirectory lib/perl5 under the given prefix. If this is not already in perl's include path, you'll need to tell perl how to get to this library directory so you can use it; there are three ways:
in your environment (the easiest):
# assuming a bourne-style shell
PERL5LIB=/some/other/place/lib/perl5/site_perl
export PERL5LIB
on the perl command line:
perl -I /some/other/place/lib/perl5/site_perl yourscript
in the code of your perl script:
use lib '/some/other/place/lib/perl5/site_perl';
This module requires these other modules and libraries:
perl >= 5.8.0
Glib >= 1.220 (Perl module)
Pango >= 1.220 (Perl module)
GTK+ > 2.x (C library)
If GTK+ is as new or newer as 2.8, the Cairo module is also required:
Cairo >= 1.00 (Perl module)
In order to build it from source, you'll also need
ExtUtils::Depends >= 0.300
ExtUtils::PkgConfig >= 1.030
Please report bugs to the gnome-perl product in GNOME's Bugzilla: <http://bugzilla.gnome.org/enter_bug.cgi?product=gnome-perl>
Copyright (C) 2003-2008 by the gtk2-perl team (see the file AUTHORS for the full list)
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.1 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA.
# $Id$