Re: XSL - Documentation

> 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"/>


back in some pre 1.0 era I used something similar for teh mathml
stylsheets eg
http://www.w3.org/Math/XSL/pmathml.xsl
(which is a combined xsl 1.0 and microsoft wd-xsl sheet:-)

basically the embedded documentation is just xhtml

<h:p>This just ensures the mathml prefix declaration isn't copied from
the source at this stage, so that the system will use the mml prefix
coming from this stylesheet</h:p>
<xsl:template match="h:html|html">
....

bit to document templates internals where you can't just drop in xhtml
as it would be a literal result element there is a simple id/ref
mechanism...

so 
<h:span doc:ref="mp">Test for MathPlayer (Design Science)</h:span>
and then inside the template...
<xsl:when doc:id="mp" test="not($activex='techexplorer-plugin') and
system-property('xsl:vendor')='Microsoft'">


see
http://www.w3.org/Math/XSL/xsldoc.xsl

which I'd more or less forgotten about it was so long ago:-)


David


________________________________________________________________________
The Numerical Algorithms Group Ltd is a company registered in England
and Wales with company number 1249803. The registered office is:
Wilkinson House, Jordan Hill Road, Oxford OX2 8DR, United Kingdom.

This e-mail has been scanned for all viruses by Star. The service is
powered by MessageLabs. 
________________________________________________________________________