[XSL-LIST Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] RE: Re: xsl/xslt coding standard
Jeni said: > Sure. You can also do it with: > > <xsl:stylesheet version="1.0" > xmlns:xsl="http://www.w3.org/1999/XSL/Transform" > xmlns:doc="doc:documentation" > extension-element-prefixes="doc"> > > <doc:module>Here's some documentation of my stylesheet</doc:module> > > <xsl:template match="/"> > <doc:template name="templateName" match="whatever"> > <doc:descr>And I can use it within templates too!</doc:descr> > <doc:result type="tNode-set">result description</doc:result> > <doc:param name="someName">Param description</doc:param> > <doc:param name="someOtherName">Param description</doc:param> > ............... > <xsl:fallback /> > </doc:template> > ... > </xsl:template> Nice one Jeni! I guess it is treated as per any extension code, hence plays no part in the normal output? > I don't think it's a massive thing, but since we're getting a new > version of XSLT anyway, we might as well fix this to make it simpler. Yes, some default ns for documentation would help, just looking at the above though, don't you think the primary code might get just a little 'buried' in the documentation? I suppose it depends on the relataive sizes, but it is a downside to 'full' documentation, as was the case with well commented C code, the comments buried the code! regards DaveP - NOTICE: The information contained in this email and any attachments is confidential and may be legally privileged. If you are not the intended recipient you are hereby notified that you must not use, disclose, distribute, copy, print or rely on this email's content. If you are not the intended recipient, please notify the sender immediately and then delete the email and any attachments from your system. RNIB has made strenuous efforts to ensure that emails and any attachments generated by its staff are free from viruses. However, it cannot accept any responsibility for any viruses which are transmitted. We therefore recommend you scan all attachments. Please note that the statements and views expressed in this email and any attachments are those of the author and do not necessarily represent those of RNIB. RNIB Registered Charity Number: 226227 Website: http://www.rnib.org.uk 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
|