Developer Documentation

[Owen Taylor <otaylor redhat com>]

Eric Baudais <baudais@okstate.edu> writes:

> Hi all-
> 
> I have been asked by Dan Mueth (GDP's fearless leader) to compile a list
> of all the documentation currently available for GNOME developers.  It
> is our (GDP's) hope that we can rearrange the current documentation so
> it is in a more central location and easier to find exactly what a
> developer needs in a timely fashion.  In other words, making the docs
> easier to find the correct information than looking directly at the
> code.

It's great that you are working on this. I will point out that
we have a central location for GNOME developer documentation
with quite extensive resources and (IMO) good organization:

 developer.gnome.org

So, your effort should be planned as "updating developer.gnome.org".
It looks like from your list, you are aware of this site - so
I just want to make sure that the GDP is planning to work on the
docs there, not create some other resource.

> ORBit-Perl binding - general doc

 (I'm not sure what you mean by "general doc". 
  http://people.redhat.com/otaylor/corba/mapping.html is a non-obvious
  resource.)

> gtk+-1.2 - API docs, tutorial
> gdk - API docs

GTK+ tutorial covers both GDK and GTK+. GGAD is a useful resource. 

> libunicode - no docs

A dead library, not really part of the GNOME platform. (It may
be used by a few things in GNOME-1.4, but it is unmaintained
and being replaced by unicode functions in GLib-2.0)

> libIDL - no docs

There is an info page with fairly complete docs, though it is a
bit out of date.

Regards,
                                        Owen