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"/> ...works for me, if it were correctly coloured grey. -- Andrew Welch http://andrewjwelch.com Kernow: http://kernowforsaxon.sf.net/
Current Thread |
---|
|
<- Previous | Index | Next -> |
---|---|---|
Re: [xsl] XSL - Documentation, James Fuller | Thread | Re: [xsl] XSL - Documentation, David Carlisle |
Re: [xsl] XSL - Documentation, DavePawson | Date | Re: [xsl] XSL - Documentation, David Carlisle |
Month |