The Definitive Guide Prev Version 1.0.3.
Comments are available almost anywhere and have a particularly broad content model.
Your processing system may or may not support either the use of comments everywhere they are allowed or the full generality of the Comment content model. Processing expectations May be formatted inline or as a displayed block, depending on context. Comments are often printed only in draft versions of a document and suppressed otherwise. Comment s must not be nested within other Comment s. Because DocBook is harmonizing towards XML , this restriction cannot be enforced by the DTD .