Syntax

  halt (with numeric-expression)?
  halt-everything (with numeric-expression)?

Argument definitions

numeric-expression

Specifies the value to be returned to the operating system after halting. If not given, the return value is one (1).

The keyword halt terminates an OmniMark program. No further OmniMark rules or actions are performed. Processing of all output files is completed, including processing of referents. Any referent resolution errors that occur will be reported.

If you need to halt the OmniMark program without trying to finish writing to files or resolving referents, use halt-everything. halt-everything terminates the program in the same manner as halt, except that referents are not resolved and no errors indicating unresolved referents are issued. The following fragment ends the program if more than 50 SGML errors occur and returns the number of SGML errors encountered to the operating system:

  markup-error
  do when #markup-error-count > 50
     put #error "Terminating because more than 50 sgml errors occurred%n"
     halt with #markup-error-count
  done

Related Syntax    process    process-end    process-start

Related Concepts    Halting an OmniMark program

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACYLIBRARIES ] [ ERRORS ]