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

Re: XSL - Documentation

Subject: Re: XSL - Documentation
From: DavePawson <davep@xxxxxxxxxxxxx>
Date: Thu, 14 May 2009 10:14:48 +0100
Re:  XSL - Documentation
David Carlisle wrote:

The restriction is only a restriction on the authoring of the
documentation, not where it appears. With the method I suggested if you
put a (namespaced) id attribute on any element internal to the template
then you can sticka <xhtml:span (or div or p or anything elese)  with a
namedspaced ref attribute and that documentation will be taken as
documenting the xslt instruction with the id, and shown just before that

So the only thing you can't directly document using this method is a
literal result element, but that isn't so much of a restriction as you
can always use an emty xsl:text to carry the documenttation.

Do you mean the doco 'external' to the template now idrefs into the template? Is that it?

Sneaky - and effective! Tiny bit more processing than weaving,
but meets the need.

Full xhtml solution Ken!

<xhtml:p>This template matches foo and makes a table</xhtml:p> <xhtml:span doc:ref="aaa"> this is a literal result element to make a table </xhtml:span> <xsl:template match="foo"> ... <xsl:text doc:id="aaa"/> <table> <thead>...



Dave Pawson

Current Thread


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.
First Name
Last Name
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.