OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   Re: [xml-dev] Documenting XSLT (Was: Note from the Troll)

[ Lists Home | Date Index | Thread Index ]

Jeni Tennison wrote:

> We've discussed documentation work-arounds in XSLT 1.0 on and off for
> years -- make the documentation elements extension elements and
> include an empty xsl:fallback; run the stylesheet through a
> de-documentation-izer before using it; use XML comments with XML
> inside that you get out via disable-output-escaping.
> None of these is exactly ideal.

As part of that discussion, one suggestion I made (which
seemed to get lost in the noise...) was to extend the
whitespace stripping mechanism instead of introducing
a specific documentation element.  That is, as well as
stripping whitespace from a stylesheet the processor
could be told to also strip elements in certain
namespaces as well.  That way, documentation could be
made to disappear from the stylesheet before execution
begins.  Since this is a general mechanism, stylesheet
designers made find it useful for other purposes too.

Perhaps this could be considered for XSLT 2.0?

Steve Ball

Steve Ball            |   XSLT Standard Library   | Training & Seminars
Zveno Pty Ltd         |     Web Tcl Complete      |   XML XSL Schemas
http://www.zveno.com/ |      TclXML TclDOM        | Tcl, Web Development
Steve.Ball@zveno.com  +---------------------------+---------------------
Ph. +61 2 6242 4099   |   Mobile (0413) 594 462   | Fax +61 2 6242 4099


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS