[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] RE: xsl/xslt coding standard
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/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
|
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
|