subsection is printing name instead of title to page

That's the expected behavior AFAIK. "title" is only supported as a standard html attribute, it is not an attribute of the xdoc section element, see http://maven.apache.org/doxia/references/xdoc-format.html.

Here's what it is actually generating:

<div class="section" title="Comparison to Decimal"><h3><a name="DecimalComparison"></a>DecimalComparison</h3>

I think this is what it should be generating:

<div class="section" title="Comparison to Decimal"><h3><a name="DecimalComparison">Comparison to Decimal</a></h3>

It is listed in the attributes if you click on "The full documentation is available here. "

http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/subsection.html#attr_title

Actually, no worries.... I'll just use the name attribute. We probably shouldn't list the title attribute in the javadocs though as it is misleading for anyone using those for reference.

I don't see the title attribute documented anywhere except in the (auto-generated) xsdddocs. As I said, it is a valid html attribute and as such simply gets copied over to the html output as is, but otherwise it is ignored by the xdoc parser.