Re: AW: commenting and documenting XSLT (small survey)

> also otherwise XML comments are totally superfluous, are they not?

No. xml comments have purposes, they for example allow you to comment out
bad (non well formed) fragments until you have time to fix them (or just
to record what was there before you removed it) also they are good for
unstructured, or non-xml structured small comments (eg CVS
identification lines) but your example had deeply structured comments,
and for that XML is much better suited than xml-comments.

XSLT was designed to allow you to mix xslt elements and xhtml elements
freely within the stylesheet. the xhtml is ignored if you run the code,
and its trivial to write a small stylesheet that swaps things around and
produces well structered xhtml documentation, based on teh xhtml
fragments from the stylesheet and some verbatim or "tree view" of the
code fragments.
see for example some examples here:

http://www.dpawson.co.uk/xsl/sect2/documentation.html

David

________________________________________________________________________
This e-mail has been scanned for all viruses by Star Internet. The
service is powered by MessageLabs. For more information on a proactive
anti-virus service working around the clock, around the globe, visit:
http://www.star.net.uk
________________________________________________________________________