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

Re: Documenting XSLT

• To: xml-dev <xml-dev@l...>
• Subject: Re: Documenting XSLT
• From: "Anthony B. Coates" <abcoates@T...>
• Date: Tue, 29 Oct 2002 20:09:29 GMT
• In-reply-to: <3DBEE61E.1000401@z...>
• References: <1ad.b129a52.2aeef6e2@a...> <200210291010.KAA29212@p...> <172241925760.20021029125505@j...> <3DBEE61E.1000401@z...>
• Reply-to: "Anthony B. Coates" <abcoates@T...>

** Reply to message from Steve Ball <Steve.Ball@z...> on Wed, 30 Oct 2002
06:48:46 +1100

Another solution would be to use a literate programming tool, like xmLP
(http://www.xmLP.org/), which keeps the documentation with the XSLT, but
nonetheless outside of the code.  Zarella Rendon gave a talk about this at this
year's Extreme.

	Cheers,
		Tony.

> > 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.
====
Anthony B. Coates, Information & Software Architect
mailto:abcoates@T...
MDDL Editor (Market Data Definition Language)
http://www.mddl.org/

• 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...>
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: Steve Ball <Steve.Ball@z...>

• 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 (Was: Note from the Troll)
• Index(es):
  • Date
  • Thread