Docs (was Re: How does one get the X window ID of a window?)

["muppet" <scott asofyet org>]

> What are you using for documentation?

mostly the C API reference docs at http://developer.gnome.org/doc/API/ -- this
is where you'll find explanations of what the objects and functions actually
do.  i originally learned Gtk+ in C so this is what seems the most natural and
useful to me.  also, gtk-perl/gtk2-perl/gtk2-perl-xs stick rather close to the
C API for the most part, so maintaining a full API reference for the perl
stuff would be wasteful duplication and thus noone has done it.

there's also the GGAD, Gtk+/Gnome Application Development, by Havoc
Pennington, available at http://developer.gnome.org/doc/GGAD/ or at big
bookstores.  (covers gtk 1.2 and gnome 1.0, but many of the concepts carry
forward to 2.x)

for gtk-perl (the 1.x bindings), if you have XML::Writer and Parse::RecDescent
installed at compile-time, the Gtk-Perl build process creates and installs
some manpages, including Gtk::reference (listing of function and method
signatures), Gtk::objects (listing of arguments and signals), and
Gtk::cookbook (some common gtk-perl idioms).  the cookbook is the only
human-written one; some distributions include these manpages, most don't.  on
my RH8 system right now, the cookook and objects pages are there, but
reference is not.

nothing like those manpages currently exists for gtk2-perl or gtk2-perl-xs,
but i think we need them.


there has also been mention here on the list of a gtk-perl tutorial that lots
of people like, giving more high-level introduction than the ones i already
mentioned, which kinda just dive in.  i haven't ever read it and i don't know
where it is -- check the list archives for april and march of '03 at
http://lists.gnome.org/archives/gtk-perl-list/index.html

-- 
muppet <scott at asofyet dot org>