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/
--~------------------------------------------------------------------
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail: <mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--