suppress

action

Syntax
suppress
    


Purpose

suppress is equivalent to

  put #suppress "%zhc"
          

In the format string %zhc,

  • z is a format modifier that turns off all translate rules,
  • h is a format modifier that turns off all line-breaking rules, and
  • c after the % is the parse continuation operator.

The following sample code demonstrates the use of suppress in a simple SGML program. The program prints all of the titles in a document whose doctype is doc.

  process
     do sgml-parse document scan #main-input
        output "%c"
     done
  
  
  element "doc"
     suppress
  
  
  element "title"
     put #main-output "%c%n"
  
  
  element #implied
     output "%c"
          

If there are subelements in title, they will be processed by the element #implied rule. output "%c" is used instead of suppress to process the content of these subelements. This ensures that the content of the subelement is sent to the same destination as the content of the parent element. If the subelement is within a title, its content will be sent to #main-output in its proper place within the title. Otherwise, it will be sent to #suppress.