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 ]


> If you want to stick some xhtml before each template saying what it
> does, just do so. What would a specific documentation element give
> you?

A documentation element (or a documentation namespace, which I'd
prefer) would enable me to stick *structured* documentation *within* a
template to explain a particular chunk of code.

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.


Jeni Tennison


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

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