Re: [xsl] XSL - Documentation

Subject: Re: [xsl] XSL - Documentation
From: Andrew Welch <andrew.j.welch@xxxxxxxxx>
Date: Wed, 13 May 2009 15:57:20 +0100
> 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"/> for me, if it were correctly coloured grey.

Andrew Welch

Current Thread