Re: [xsl] Annotations in XSLT

Cart

XML Editor - Download a Free Trial >

See What's New >

Buy Now >

[Home] [By Thread] [By Date] [Recent Entries]

Subject: Re: Annotations in XSLT
From: Joern Nettingsmeier <nettings@xxxxxxxxxxxxxxxxxxxxxx>
Date: Sun, 05 Mar 2006 12:39:41 +0100

Jesper Tverskov wrote:

Hi list,

Could someone point me to some BEST PRACTICE examples of how to annotate an
XSLT stylesheet?

We can use the comment element, as I have done so far,
http://www.xmltraining.biz/xmltraining/prolog.xslt, but I am looking for
something similar to what we can do in XML Schema. Here we have the
xs:annotation element with xs:documentation and xs:appinfo as children.

the problem with  comments is that you can't easily comment out code blocks for debugging, since nested comments are illegal.

for custom comments, you could use the "exclude-result-prefixes" attribute of <xsl:stylesheet/> and put all your comments in a separate namespace.

as to re-using an existing grammer as opposed to making up one on-the-fly, i would also be interested in recommendations from list members. is there something similar to javadoc that can extract documentation from xml files?


--
jvrn nettingsmeier

home://germany/45128 essen/lortzingstr. 11/
http://spunk.dnsalias.org
phone://+49/201/491621

if you are a free (as in "free speech") software developer
and you happen to be travelling near my home, drop me a line
and come round for a free (as in "free beer") beer. :-D

Current Thread
Annotations in XSLT Jesper Tverskov - 5 Mar 2006 10:54:37 -0000 Joern Nettingsmeier - 5 Mar 2006 11:39:59 -0000 <= Colin Paul Adams - 5 Mar 2006 11:49:35 -0000 G. Ken Holman - 5 Mar 2006 13:47:23 -0000 Didier PH Martin - 5 Mar 2006 14:46:15 -0000 Joern Nettingsmeier - 5 Mar 2006 17:10:38 -0000

<- Previous	Index	Next ->
Annotations in XSLT, Jesper Tverskov	Thread	Re: Annotations in XSLT, Colin Paul Adams
Annotations in XSLT, Jesper Tverskov	Date	Re: Annotations in XSLT, Colin Paul Adams
	Month

XML Editor - Download a 15 Day Free Trial Now >

See What's New in Stylus Studio >

Buy Stylus Studio - XML Editor - Now >