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

XSLT Documentation (Was: RE: How is this part of the XSLT s

Subject: XSLT Documentation (Was: RE: How is this part of the XSLT specification to be interpreted?)
From: Jeni Tennison <Jeni.Tennison@xxxxxxxxxxxxxxxx>
Date: Thu, 22 Jun 2000 11:39:56 +0100
xslt documentation
David Pawson wrote:
>Stylesheet that operates on our Knuthian stylesheet and outputs
>HTML. OK.... I'd missed that one totally.
>Hence the schema for documentation, to permit this to be 
>'standardised'?

I'm missing the Knuth reference, but yes.  The components that we need are:

1. a schema for documenting XSLT (XSLTDocML, for sake of argument)

2. one or more XSLT stylesheets that can take an XSLT stylesheet documented
with XSLTDocML and produce a browsable version of the documentation

3. one or more implementations of the extension elements that can... do
something useful within the XSLTDocML documentation when the XSLT
stylesheet is used

On the final point, you could imagine the documentation giving an extended
version of xsl:message, so that I could have in my XSLT stylesheet
something like:

  <doc:comment><xsl:fallback />
    When <doc:var>$foo</doc:var> is equal to 'bar', ...
  </doc:comment>
  <xsl:if test="$foo = 'bar'">
    ...
  </xsl:if>

During run time, the XSLT processor that understood the documentation
extension elements would recognise the documentation, interpret it, and
give the message:

  When $foo ('baz') is equal to 'bar', ...

You could turn this documentation-interpreting facility on and off
depending on the arguments to the XSLT Processor.  I think that could be
really useful: I could take my debugging messages out, and put
documentation in instead.

There must be code-documenting mark-up languages out there already that we
could adapt if necessary.  Anyone know of any?

Cheers,

Jeni

Dr Jeni Tennison
Epistemics Ltd, Strelley Hall, Nottingham, NG8 6PE
Telephone 0115 9061301 ? Fax 0115 9061304 ? Email
jeni.tennison@xxxxxxxxxxxxxxxx



 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.