Comment Information Items (SAX2)

B.9. Comment Information Items

Comments are intended for human consumption; processing instructions are reserved for application data. The main curiosity here is that the Infoset doesn't believe in comments within DTDs, perhaps on the grounds that they'd need to be associated with the declarations they describe. (Some DTD documentation tools rely on magic comment syntax, much like javadoc.)

Property	Callbacks	Explanation
[content]	`LexicalHandler.comment()`	The characters identified in this callback are the contents of the comment.
[parent]		When `startElement()` is invoked with no matching `endElement()`, the parent is the current element. The Infoset ignores comments reported between calls to `LexicalHandler.startDTD()` and `LexicalHandler.endDTD()`. Otherwise, the document itself is the parent.

Some legacy applications use comments to represent the sort of information that processing instructions were designed to hold; an example is wrapping of CSS rendering hints in HTML comments.