Hi Bob,
sounds reasonable.
A tempting approach would be to check if the match is not the first
occurrence of ooclass|oointerface|ooexception in a classsynopsis and
there is a following sibling instead (including moving the choose
statement behind the span).
Then again this might of course break other stuff I do not now about.
Please let me know if I can assist in getting this resolved in a future
release.
Do you need a bug filed for this at the Sourceforge Tracker?
Regards,
Torsten
On 29.10.2015 17:38, Bob Stayton wrote:
Hi Torsten,
Thanks for the report. It is unfortunate that it wasn't filed as a bug
report earlier so it could be fixed. I'm unclear how to fix this as I'm
not very familiar with the synop templates. I'm concerned about
introducing further bugs into a release that's about to go out.
Bob Stayton
Sagehill Enterprises
b...@sagehill.net
On 10/29/2015 3:25 AM, Torsten Stolpmann wrote:
Hi Bob,
we use DBDoclet (http://www.dbdoclet.org/) to auto-generate
API-Documentation for DocBook.
Using the DocBook 1.79.0 stylesheets for html and fo output formats, the
following behavior also occurred with prior stylesheet versions:
When rendering a derived class in java the following output appears
(notice the trailing comma):
public final class Foo extends,
Bar
{
}
The corresponding Docbook source generated by DBDoclet looks like the
following:
<section xreflabel="Foo" xml:id="dbdoclet-class-Foo">
<title>Foo</title>
<para>The Foo class.</para>
<section>
<title>Synopsis</title>
<classsynopsis class="class" language="java">
<ooclass>
<modifier>public</modifier>
<modifier>final</modifier>
<modifier>class</modifier>
<classname>Foo</classname>
</ooclass>
<ooclass>
<classname>
<link linkend="dbdoclet-class-Bar">Bar</link>
</classname>
</ooclass>
</classsynopsis>
</section>
</section>
I think this is rooted in the implementation of the following match
which does not recognize being called from a classsynopsis:
<xsl:template match="ooclass|oointerface|ooexception" mode="java">
<xsl:choose>
<xsl:when test="preceding-sibling::*">
<xsl:text>, </xsl:text>
</xsl:when>
<xsl:otherwise>
<xsl:text> </xsl:text>
</xsl:otherwise>
</xsl:choose>
<span>
<xsl:apply-templates select="." mode="common.html.attributes"/>
<xsl:call-template name="id.attribute"/>
<xsl:apply-templates mode="java"/>
</span>
</xsl:template>
I think that the dbdoclet output is correct and this is a bug in the
stylesheets.
Otherwise the 1.79.0 release seems to be working great over here.
Regards,
Torsten
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org
