[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: AndrewWatt2000@a...
• Subject: Re: Documenting XSLT (Was: Note from the Troll)
• From: "J.Pietschmann" <j3322ptm@y...>
• Date: Mon, 28 Oct 2002 22:03:50 +0100
• Cc: xml-dev@l...
• References: <107.1a53850f.2aeef53b@a...>
• User-agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US; rv:1.1) Gecko/20020826

AndrewWatt2000@a... wrote:
> The problem might, at least partly, be attributed to the absence of a 
> documentation element in XSLT 1.0.

Look into the XSLT spec, section 2.2 Stylesheet Element, last paragraph:
  In addition, the xsl:stylesheet element may contain any element not from
  the XSLT namespace, provided that the expanded-name of the element has a
  non-null namespace URI. .... Such elements can provide, for example,
  ...
  *  metadata about the stylesheet,
  *  structured documentation for the stylesheet.

IIRC Norm Walsh uses this extensively for the documentation of his
DocBook style sheets. You might want to have a look at it.

J.Pietschmann

• References:
  • Documenting XSLT (Was: Note from the Troll)
    • From: AndrewWatt2000@a...

• Prev by Date: Re: Documenting XSLT (Was: Note from the Troll)
• Next by Date: Re: Documenting XSLT (Was: Note from the Troll)
• 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