Re: GTK+ doc

[Luke Scharf <luke vt edu>]

Carlos Pereira wrote:
> > I'm new to Linux programming and I think that sometimes it is
> > difficult to find, in the Gtk+ documentation, a signal/widget/event...
> > (e.g.: gtk_window_*) that I know the name. Why not adding a content page
> > having as sections: signals, widgets, events... sorted?
>
> See the API reference, at www.gtk.org,
> I think this is exactly what you are looking for.
>
> It has information for GTK 1.2 and GTK 2.0

With all due respect, the API reference isn't very good.  It shows the
function prototypes and has some blurbs about some of the functions for
some of the widgets.

It doesn't describe how the designers expected the pieces to go
together, or expected policies for allocating/deallocating of things
like list data.  In the case of GDK, the documentation doesn't even
describe the format of the data coming into the functions - case in
point gdk_image_new_bitmap().

Some of the tutorials are very good, but they don't go into the depth
that is necessary to really get work done.

I've been meaning to start writing the kind of documentation I'd like to
see, but, as with many things, I haven't done it yet.  It's a shame that
the documentation is so poor - this is a big obstacle for *anyone*
trying to learn GTK+ programming.

-Luke

P.S. I've written and released two applets with GTK+ gui's - and I still
spend days upon days trying to figure out things that I could do in an
hour if I knew how things were supposed to work.
http://www.ccm.ece.vt.edu/~lscharf/rdp/
http://www.ccm.ece.vt.edu/~lscharf/pcmics2/
Bug fixes and other applets to come.  :-)

My point is that I probably represent the "target" user of the GTK+
API.

-- 
Luke Scharf, Student Researcher & Sysadmin
Virginia Tech Configurable Computing
http://www.ccm.ece.vt.edu/~lscharf
:wq