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

RE: Comments

• From: Ramin Firoozye <ramin@w...>
• To: "Al B. Snell" <alaric@a...>,The Deviants <xml-dev@l...>
• Date: Sun, 15 Apr 2001 18:12:57 -0700

In HTML, a common practice is to surround <script> tags containing
Javascript code with comments of the <!-- --> form. This was done to allow
older browsers to not break on unknown <script> tags. For some reason, this
practice seems to have continued with XHTML. Also, there are quite a few
cases where JavaDoc-type constructs have been embedded inside XML comments.

Are these the kinds of comments you're thinking about?

ramin

> -----Original Message-----
> From: Al B. Snell [mailto:alaric@a...]
> Sent: Saturday, April 14, 2001 6:41 PM
> To: The Deviants
> Subject: Comments
>
>
>
> Quite a few schemas now have provision for comments, which can do stuff
> like import from XHTML or DocBook namespaces. This clearly allows for rich
> comments, unlike <!-- --> comments. Does this mean that <!-- --> comments
> should be discouraged, except perhaps for "commenting out" bits as a
> temporary measure during development and the like? Is there a semantic
> difference between comments on the *information* as opposed to comments on
> the markup, which <!-- --> are for?
>
> Not that I urgently need an answer, I was just sitting thinking about it
> (can't sleep, y'see)
>
> <!-- --> comments, like <?foo ?> PIs, seem to be one of those bits of XML
> that nobody ever uses. At least, I never see them in the coding examples
> around here. Oh yeah, and that <!NOTATION > thing is a bit of a pariah,
> too... does anybody use entities to refer to stuff in favour of <foo
> href="..." />, anyway? The latter seems much more convenient, since it
> doesn't require all definitions to be gathered inside the <!DOCTYPE >...
>
> ABS
>
> --
>                                Alaric B. Snell
>  http://www.alaric-snell.com/  http://RFC.net/  http://www.warhead.org.uk/
>    Any sufficiently advanced technology can be emulated in software
>
>
> ------------------------------------------------------------------
> The xml-dev list is sponsored by XML.org, an initiative of OASIS
> <http://www.oasis-open.org>
>
> The list archives are at http://lists.xml.org/archives/xml-dev/
>
> To unsubscribe from this elist send a message with the single word
> "unsubscribe" in the body to: xml-dev-request@l...
>

• Follow-Ups:
  • RE: Comments
    • From: "Al B. Snell" <alaric@a...>

• References:
  • Comments
    • From: "Al B. Snell" <alaric@a...>

• Prev by Date: Re: XML Schema 1.1
• Next by Date: Re: PSVI in XML
• Previous by thread: Comments
• Next by thread: RE: Comments
• Index(es):
  • Date
  • Thread