Michael Kay,
I thank you for your reply.
I have questions regarding this.
1. Is it feasible to insert some xml statements in
place of <!-- --> comment statment?
2. I thought this tag command is similar to Java tag (doc) commands
like @author, @see and so on.
3. If we have some xml doc inside the xsl file, how the
developer will feel to do that documentation?
thanks and regards,
sundar
-----Original Message-----
From: Michael Kay [mailto:mhk(_at_)mhk(_dot_)me(_dot_)uk]
Sent: Thursday, April 24, 2003 9:04 PM
To: xsl-list(_at_)lists(_dot_)mulberrytech(_dot_)com
Subject: RE: [xsl] XSLDOC
I have tried to create a tool to document XSL.
All the xsl documents will have tag commands like this:
<!--(_at_)overview This xsl page is used to calculate the
factorial of a given number -->
Horrible! Why invent your own markup syntax instead of using XML?
Use something like:
<doc:overview>This xsl page is used to calculate the
factorial of a given number</doc:overview>
Then you can use XSLT to manipulate the documentation.
Other people have done work on stylesheet annotation, I'm sure there's
something you can re-use but I can't point you to it.
Michael Kay
Software AG
home: Michael(_dot_)H(_dot_)Kay(_at_)ntlworld(_dot_)com
work: Michael(_dot_)Kay(_at_)softwareag(_dot_)com
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list