Re: [docbook-apps] oointerface - writing a synopsis for a Java interface

From
Michael(tm) Smith <>
Date
2006-12-12T08:23:56+00:00
ID
Thread
Re: [docbook-apps] oointerface - writing a synopsis for a Java interface
Mauritz Jeanson <>, 2006-12-11 20:20 +0100:

> One reason for the confusion, I think, is that the official documentation
> (The Definitive Guide) isn't detailed enough. In particular, there are too
> few usage examples and the processing expectations are often a little vague.
> 
> Many descriptions of source code-related elements in TDG don't have a single
> example. See http://docbook.org/tdg/en/html/classsynopsis.html, for
> instance.

I think patches to TDG would probably be welcome. The sources are here:

  https://svn.sourceforge.net/svnroot/docbook/trunk/defguide/en/refpages/elements
  https://svn.sourceforge.net/svnroot/docbook/trunk/defguide5/en/refpages/elements