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