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

Re: xsl/xslt coding standard

Subject: Re: xsl/xslt coding standard
From: Jeni Tennison <jeni@xxxxxxxxxxxxxxxx>
Date: Thu, 15 Aug 2002 11:46:42 +0100
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


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.