Both your suggested solutions used comments <!-- --> but why do that?
XSLT allows (at the top level) any elements from any foreign namespace
so you can, for example, put xhtml comments there directly.
It's much easier to control.validate teh documentation if it is in the
XML element structure rather than all justhidden in a comment.
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
________________________________________________________________________