[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: David Carlisle <davidc@n...>
• Subject: Re: Documenting XSLT (Was: Note from the Troll)
• From: Jeni Tennison <jeni@j...>
• Date: Tue, 29 Oct 2002 13:21:54 +0000
• Cc: xml-dev@l...
• In-reply-to: <200210291304.NAA05848@p...>
• Organization: Jeni Tennison Consulting Ltd
• References: <1ad.b129a52.2aeef6e2@a...><200210291010.KAA29212@p...><172241925760.20021029125505@j...><200210291304.NAA05848@p...>
• Reply-to: Jeni Tennison <jeni@j...>

Hi David,

>> A documentation element (or a documentation namespace, which I'd
>> prefer)
>
> not sure how you'd see a documentation namespace working, you mean
> that any element in the specified namespace would be ignored by the
> stylesheet?

Yep. It would work in the same way as extension namespaces, so you'd
list prefixes that were classed as documentation namespaces, and the
processor would just ignore them.

> Given that you'd presumably fill up the wrapper element with docbook
> or xhtml or something, I'm not sure having a method of declaring
> documentation (as opposed to extension) namespaces would really be
> extra functionality over an xsl:documentation element would it? But
> perhaps you have a use in mind...

Only that it's less tedious to say that 'html' is a prefix for a
documentation namespace and write:

  <html:p>blah blah blah</html:p>

than it is to have to write:

  <xsl:documentation>
    <html:p>blah blah blah</html:p>
  </xsl:documentation>

each time you want to add a comment.
  
Cheers,

Jeni

---
Jeni Tennison
http://www.jenitennison.com/

• Follow-Ups:
  • RE: Documenting XSLT (Was: Note from the Troll)
    • From: "Danny Ayers" <danny666@v...>
  • Re: Documenting XSLT (Was: Note from the Troll)
    • From: David Carlisle <davidc@n...>

• 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: David Carlisle <davidc@n...>

• 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