This is the mail archive of the
xsl-list@mulberrytech.com
mailing list .
RE: xsl/xslt coding standard
- From: DPawson at rnib dot org dot uk
- To: xsl-list at lists dot mulberrytech dot com
- Date: Thu, 15 Aug 2002 13:06:26 +0100
- Subject: RE: [xsl] xsl/xslt coding standard
- Reply-to: xsl-list at lists dot mulberrytech dot com
Jeni wrote:
> 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:
I've been using this form for some time, and follow it with
a mix of Chris's javascript to trawl for all xsl files in the project
directory, list them, then process them with a stylesheet to produce
a revision history.
Slightly different purpose, but similar goals.
My basic stylesheet now dumps:
<d:doc xmlns:d="rnib.org.uk/tbs#">
<revhistory>
<purpose><para></para></purpose>
<revision>
<revnumber></revnumber>
<date></date>
<authorinitials>DaveP</authorinitials>
<revdescription>
<para></para>
</revdescription>
<revremark></revremark>
</revision>
</revhistory>
</d:doc>
from emacs for any new xsl file.
New revision elements are added as needed.
I've normally used xml comments (rather than <xsl:comment>)
before each template. I find context for named templates a must.
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