> But do we want users to have to learn yet another markup language?

Reminds me trying to add something to a Wiki... you spend 15 minutes
looking up how to make a bulletted list or some text bold....
frustrating to the point of not bothering.

> It seems to me that the obvious place to document a function parameter is an
> extension attribute on the xsl:param element:
>
> <xsl:param name="fo_tree" x:doc="Pointer to generated FO tree"/>

Sentences in attributes aren't the nicest, much better as an element
somewhere, although for empty elements, where that documentation
element goes is not obvious.

<x:doc>Pointer to generated FO tree</x:doc>
<xsl:param name="fo_tree"/>

...works for me, if it were correctly coloured grey.



-- 
Andrew Welch
http://andrewjwelch.com
Kernow: http://kernowforsaxon.sf.net/