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

Re: Documenting XSLT (Was: Note from the Troll)

• To: Jeni Tennison <jeni@j...>
• Subject: Re: Documenting XSLT (Was: Note from the Troll)
• From: Steve Ball <Steve.Ball@z...>
• Date: Wed, 30 Oct 2002 06:48:46 +1100
• Cc: David Carlisle <davidc@n...>, AndrewWatt2000@a..., xml-dev@l...
• In-reply-to: <1ad.b129a52.2aeef6e2@a...>
• Organization: Zveno Pty Ltd
• References: <1ad.b129a52.2aeef6e2@a...> <200210291010.KAA29212@p...> <172241925760.20021029125505@j...>
• Reply-to: Steve.Ball@z...
• User-agent: Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en-US; rv:1.2b) Gecko/20021016

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?

Cheers,
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@z...  +---------------------------+---------------------
Ph. +61 2 6242 4099   |   Mobile (0413) 594 462   | Fax +61 2 6242 4099

• Follow-Ups:
  • Re: Documenting XSLT
    • From: "Anthony B. Coates" <abcoates@T...>

• References:
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: AndrewWatt2000@a...
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: David Carlisle <davidc@n...>
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: Jeni Tennison <jeni@j...>

• Prev by Date: RE: XML Object Serialization
• Next by Date: Re: XML Object Serialization
• Previous by thread: Re: Documenting XSLT (Was: Note from the Troll)
• Next by thread: Re: Documenting XSLT
• Index(es):
  • Date
  • Thread