Subject: RE: [xsl] XSLDOC From: Sundar Shanmugasundaram <SSHANMUGASUNDARAM@xxxxxxxxxxxxx> Date: Thu, 24 Apr 2003 21:07:58 +0530 |
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@xxxxxxxxx] Sent: Thursday, April 24, 2003 9:04 PM To: xsl-list@xxxxxxxxxxxxxxxxxxxxxx Subject: RE: [xsl] XSLDOC > I have tried to create a tool to document XSL. > All the xsl documents will have tag commands like this: > > <!--@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.H.Kay@xxxxxxxxxxxx work: Michael.Kay@xxxxxxxxxxxxxx XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list XSL-List info and archive: http://www.mulberrytech.com/xsl/xsl-list
Current Thread |
---|
|
<- Previous | Index | Next -> |
---|---|---|
RE: [xsl] XSLDOC, Michael Kay | Thread | RE: [xsl] XSLDOC, Prakash, Mayank |
RE: [xsl] XSLDOC, Michael Kay | Date | Re: [xsl] FOP conversion font probl, Oleg Tkachenko |
Month |