RE: [xsl] xsl/xslt coding standard

Subject: RE: [xsl] xsl/xslt coding standard
From: "Andrew Welch" <awelch@xxxxxxxxxxxxxxx>
Date: Thu, 15 Aug 2002 12:31:42 +0100
I would extend that a little maybe to add some functionality to it, so
you could produce api docs javadoc stylee, listing template names,
functionality, params etc

It would certainly benefit projects like fxsl, or maintaining
stylesheets that are unfamiliar 


cheers
andrew

> -----Original Message-----
> From: Jeni Tennison [mailto:jeni@xxxxxxxxxxxxxxxx]
> Sent: 15 August 2002 11:47
> To: xsl-list@xxxxxxxxxxxxxxxxxxxxxx
> Subject: Re: [xsl] xsl/xslt coding standard
> 
> 
> Mike Brown wrote:
> > I add frequent comments to explain why I'm doing whatever I'm doing.
> 
> At an XSLT Q&A in Oxford recently, someone asked about adding comments
> to stylesheets, and it made me think of the discussions we had ages
> ago about the different ways of embedding *structured* comments in
> a stylesheet. We talked then about using extension elements, but it's
> a real pain because you have to have xsl:fallback in each of them to
> stop processors getting worried.
> 
> One possibility that came to mind, though, was being able to specify
> one or more documentation-element namespaces for adding documentation
> to the stylesheet. So something like:
> 
> <xsl:stylesheet version="2.0"
>                 xmlns:xsl="http://www.w3.org/1999/XSL/Transform";
>                 xmlns:html="http://www.w3.org/1999/xhtml";
>                 documentation-element-prefixes="html">
> 
> <html:p>Here's some documentation of my stylesheet</html:p>
> 
> <xsl:template match="/">
>   <html:p>And I can use it within templates too!</html:p>
>   ...
> </xsl:template>
>                 
> </xsl:stylesheet>
> 
> What do y'all think?
> 
> Cheers,
> 
> Jeni
> 
> ---
> Jeni Tennison
> http://www.jenitennison.com/
> 
> 
>  XSL-List info and archive:  http://www.mulberrytech.com/xsl/xsl-list
> 
> 
> 
> 
> 
> ---
> Incoming mail is certified Virus Free.
> Checked by AVG anti-virus system (http://www.grisoft.com).
> Version: 6.0.381 / Virus Database: 214 - Release Date: 02/08/2002
>  
> 

---
Outgoing mail is certified Virus Free.
Checked by AVG anti-virus system (http://www.grisoft.com).
Version: 6.0.381 / Virus Database: 214 - Release Date: 02/08/2002
 

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


Current Thread