marked-section include-end

rule

Syntax
marked-section include-end condition?
   action*


Purpose

Unlike most marked section rules, include rules are split into two sets of rules: marked-section include-start rules and marked-section include-end rules. This is because an include-marked section can start in the context of one element and end in the context of another, and so can overlap the structure that ties together the components of a parsed SGML document.

marked-section include-end applies to the end of the marked section:

  • If no marked-section include-end rule is performed at the end of an include-marked section, then the ending markup is ignored by the OmniMark program (though not by the SGML parser).
  • Only one marked-section include-end rule may be selected for each marked section. If more than one rule applies, then each must have a condition. It is an error for more than one marked-section include-end rule to be selected for an include-marked section.
  • Only marked sections in the document are available for processing by an OmniMark program. Marked sections in the DTD are always ignored, whether or not there is a marked-section rule in the OmniMark program.
  • Neither the %c operator nor the suppress action can be used in a marked-section include-end rule.

The following is an example of a marked-section include-end rule:

  marked-section include-end
     do when element is (p | title)
        output " (End of bracketed text)"
     else
        output "(End of bracketed text)%n"
     done