[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

RE: XSLDOC

Subject: RE: XSLDOC
From: Sundar Shanmugasundaram <SSHANMUGASUNDARAM@xxxxxxxxxxxxx>
Date: Thu, 24 Apr 2003 21:07:58 +0530
shanmugasundaram
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


Current Thread

PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.