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?
--
jörn 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
--~------------------------------------------------------------------
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
To unsubscribe, go to: http://lists.mulberrytech.com/xsl-list/
or e-mail: <mailto:xsl-list-unsubscribe(_at_)lists(_dot_)mulberrytech(_dot_)com>
--~--