[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: XSL - Documentation

Subject: Re: XSL - Documentation
From: Andrew Welch <andrew.j.welch@xxxxxxxxx>
Date: Wed, 13 May 2009 15:57:20 +0100
Re:  XSL - Documentation
> 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

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.