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

["Michael(tm) Smith" <smith@sideshowbarker.net>]

Mauritz Jeanson <mj@johanneberg.com>, 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

smime.p7s