RE: [gtk-list] Re: Experimental GTK DocBook documentation

["Damon Chaplin" <DAChaplin email msn com>]

> I vote for a reference into the source code to an external file base
> name, like this:
> 
> /*
> **	<gtkbook>
> **	  <function name="gtk_blah_blah_blah">
> **	    <parameters>
> **	      <parameter name="blih" type="bloh">
> **	      :
> **	    </parameters>
> **	    <description>
> **		This function zag zeg zig zog zug
> **	    </description>
> **	    <doc file="gtk_blah_blah_blah">
> **	  </function>
> **	</gtkbook>
> */


Even this is going to make the source code very ugly.
I'm beginnning to think we should keep the GTK users' documentation
completely separate, and leave the source files for GTK maintainers'
documentation.

Damon