Examples in documentation

["Tim P. Gerla" <timg means net>]

I have a question. Is there any provision for complete examples in the
GNOME doc framework? I want to be able to write a complete compilable
example for a certain widget, and put a link to it in the widget doc page.
Then I want to put only the widget-specific code in the main page. I want
the complete example to be html-formatted C code with hyperlinks to the
various function calls, and then I want a link to a plain-text version of
the code so that the user can save & compile.

Any thoughts? Is this doable? Thanks!

-Tim