docbook markup in inline docs

["Matthias Clasen" <matthiasc poet de>]

Damon, any progress with the sgml-mode idea for gtk-doc ?
I have put a patch in bugzilla which adds an --sgml-mode option
to gtkdoc-mkdb, any comments on that ? It would be really
nice to get something like that included. (There are some more 
outstanding patches in bugzilla, but this one is the most important
one for me.)

On to new questions: 

1) gtk-doc treats "Standard" GObject functions and macros be not 
documenting them at all. Are there any ideas to change this, eg by
refering to a section in the GObject docs describing the standard
definitions ? What are the standard definitions for a GObject type,
and what do we do if only some of the standard definitions are there ?
(this question came up when I put a patch in bugzilla which would
 move all standard defines in Pango in the Standard sections, thereby
 effectively making them undocumented)

2) What about images ? I feel that the gtk+ API docs really need
screenshots of all widgets and stock items. I guess that would mean
to extend the docbook DTD for pngs. Are there any ideas how to
organize this ? Where should the images live, in docs/reference/gtk+
or a new subdirectory docs/reference/gtk+/images ?

Matthias