gtk-perl

gtk2-perl tries to be perlish, so as to be comfortable and familiar for perl programmers; but it also tries to stick very close to the C API, so that any reference material, tutorials, example code, or programming experience you have with Gtk+ in any language can still be useful.

So, the C API reference documentation at developer.gnome.org will be very useful even when developing in gtk2-perl; use it in conjuction with the guidelines for translating the C API to Perl as described in Gtk2::api.

Gtk3 documentation

Documentation for the Gtk3 module and it's dependencies can be viewed via the perli11ndoc tool that is installed with the Gtk3 Perl module. The perli11ndoc tool will also show documentation for any other introspectable GTK+ modules that are installed on your system. You can find out more about Introspection in Gtk-Perl in the Gtk-Perl Introspection page.

Run the perli11ndoc tool by calling it in the shell once the Gtk3 Perl module is installed on your system.

Gtk3 Tutorials

• https://github.com/kevinphilp/Perl-gtk3-Tutorial - A basic introduction to using the Gtk3 toolkit with the Perl bindings.
• https://github.com/dave-theunsub/gtk3-perl-demos - Re-writes of the Gtk2 demos using the Gtk3 bindings.
• https://github.com/MaxPerl/perl-Gtk3-Tutorial - A tutorial about Perl Gtk3 based on the Python tutorial.
• Gtk3 and Windows/MSys2, including how to create an installer for Perl/Gtk3 applicaitons on Windows.

Gtk2 documentation

Documentation for the Gtk2 module is available via the perldoc utility once the Gtk2 module is installed. You can also view copies of the documentation in your browser below;

• Online Gtk2-Perl Documentation generated with Marek::Pod::HTML, using Gtk2 1.221/Glib 1.222/Pango 1.221/Cairo 1.061 checked out from the GIT repo.
• Tarball of the Gtk2-Perl Documentation generated with Marek::Pod::HTML (.tar.bz2, 560k, generated 17Dec2009)
• Online Gtk2-Perl Documentation generated with Pod::ProjectDocs, using Gtk2 1.221/Glib 1.222/Pango 1.221/Cairo 1.061 checked out from the GIT repo.
• Tarball of the Gtk2-Perl Documentation generated with Pod::ProjectDocs (.tar.bz2, 691k, generated 17Dec2009)

If all else fails, and you feel the need to cry for help, discuss gtk2-perl with the authors on the gtk-perl mailing list. You can search the list archives at markmail or on gnome.org gtk-perl list archives.

There are links to several tutorials for other programming languages on the links page.

Gtk2 Tutorials

• For those looking for a quick start, Ross McFarland has written an Introduction to GUI Programming with Gtk2-Perl
• We also have some of the example programs from the source distribution.
• Gtk2-Perl Study Guide by Dirk van der Walt. Note: This study guide used to be hosted at Novell's developer website, but went offline around October 2010. This is a local copy of the study guide, hosted by the Gtk2-Perl project. You can download the sample programs in their own tarball, or you can download the full HTML study guide with samples/optional scripts for offline viewing:
• Gtk2-Perl Study Guide - sample and optional programs - no documentation, sample and optional programs only.
• Gtk2-Perl Study Guide (HTML) - The contents of the study guide in HTML format, and with sample and optional programs.
• Gtk2-Perl Study Guide (DocBook XML Source) - with sample and optional programs.
• English Gtk2-Perl Tutorial (alpha version)
• French Gtk2-Perl Tutorial by Patrice Le-Borgne.
• Subclassing Widgets In Perl - A quick tutorial on creating your own widgets and objects with pure Perl code.
• Unicode A general tutorial/presentation including information about unicode character encodings, Dov Grobgeld

Binding Developers

Things to help in creating bindings for lib- or GObject-based libraries:

• Binding HowTo - How to write bindings for Gtk/GObject-based libraries
• ExtUtils::Depends - Easily build XS extensions that depend on XS extensions
• ExtUtils::PkgConfig - A simplistic interface to pkg-config
• Gtk2::CodeGen - Autogeneration of boot and type registration code
• Glib::xsapi - The internal API reference for the Glib module
• Glib::devel - Binding developer's overview of the Glib internals
• Gtk2::devel - The internal workings of the gtk2-perl language bindings
• the original design document for the bindings themselves can be helpful in figuring out how it all works; now a little obsolete.
• Need to learn XS? XS Mechanics is an excellent resource.

Older/deprecated tutorials and documentation

• Guide to porting from Gtk-Perl to Gtk2-Perl
• Using Gtk2::GladeXML, another tutorial by Patrice Le-Borgne.
• Spanish Gtk2-Perl Tutorial by Alejandro Garrido Mota.