RE: XSLDOC

Not if you declare a doc namespace, such as:

   <xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
       xmlns:doc="http://my.com/MyXSLExtensions">

-----Original Message-----
From: Prakash, Mayank [mailto:Mayank.Prakash@xxxxxxx]
Sent: Thursday, April 24, 2003 11:40 AM
To: 'xsl-list@xxxxxxxxxxxxxxxxxxxxxx'
Subject: RE:  XSLDOC


Doesn't this break the stylesheet? If the annotations are outside of a 
template, then it is incorrect XSLT syntax, and if inside, they will 
get copied to the output? Or am I missing something?

Thanks.
 
  Mayank.


-----Original Message-----
From: Michael Kay [mailto:mhk@xxxxxxxxx] 
Sent: Thursday, April 24, 2003 11:34 AM
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

 XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list