[Home] [By Thread] [By Date] [Recent Entries]

  • From: michael odling-smee <mike.odlingsmee@g...>
  • To: Pete Cordell <petexmldev@c...>
  • Date: Sun, 5 Dec 2010 11:39:20 +0000

On Sun, Dec 5, 2010 at 11:01 AM, Pete Cordell <petexmldev@c...> wrote:
> Initially I liked the <xml:comment>....</xml:comment> idea, but I now agree
> with Greg that comments should allow non well-formed data.  Since a comment
> looking like an element would suggest it was well-formed, I think a
> non-element style format should be used.  Tweaking XML 1.0 comments seems
> sufficient rather than a wholesale replacement.

There seems to be two main uses of comments in XML today which is
aligned with the two schools of thought in this thread:

1.] Simply commenting out code or adding TODOs etc. - similar use to
standard code comments.
2.] Adding structured documentation - similar to JavaDoc/annotations.

As these have different uses perhaps we need two different constructs.
For the simple code comment perhaps we just need a refined version of
the current XML 1.0 comment, for the structured documentation perhaps
we need something along the lines of
<xml:documentation></xml:documentation> with the potential for nested
structures.

Michael
www.xml-solutions.com


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index]


Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member