| Syntax 
   markup-comment conditon?
     action+
 Purpose
 
 A rule that is performed whenever an SGML or XML comment is found in an SGML or XML document and the condition (if any) is met.
 The following statements apply to markup-commentrules: If no markup-commentrule is performed for an SGML or XML comment, then the comment text is discarded.If an OmniMark program contains no markup-commentrules, then all comments are discarded.Only one markup-commentrule may be selected for an SGML or XML comment. That is, either there must be only onemarkup-commentrule or, if there is more than one, each rule must have a condition so that only one rule applies to any given comment. It is an error for more than onemarkup-commentrule to be selected for an SGML or XML comment.There may be zero, one, or more than one SGML or XML comment in any declaration in a document, including in a comment declaration.
The %coperator captures the text of a comment. Either%corsuppressmust be used exactly once in amarkup-commentrule. The "u", "l", "s", "h", and "z" format modifiers can be used on a%coperator in amarkup-commentrule.The text of a comment consists of all the characters between, but not including, the two comment delimiters ("--" and "--") and including any record ends or white space within the comment.
SGML comments in the SGML Declaration are always ignored, whether or not there are any markup-commentrules in the OmniMark program. All comments in the document prolog (containing the DTD) and document instance are available for processing.The presence of markup-commentrules affects howtranslaterules match text around a comment in the following fashion:Any translaterules in progress when the SGML or XML comment is encountered are terminated, andtranslaterule processing is suspended until the comment is processed.The comment is processed if one of the markup-commentrules apply to the comment (that is, there is a rule in the currently active groups either with no condition or a condition that succeeds).The comment is ignored if no markup-commentrules apply.translaterule processing is resumed.
 This is an example of markup-commentrules with conditions:
   markup-comment when element is p
     output " (note: %c)"
  markup-comment when element isnt p
     output "   note: %c%n"
 |