[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] RE: XSLDOC
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: 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
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|