include file-name

Where:
file-name

A quoted string containing a system-specific file name.

Includes a source file in the current program. The content of the indicated file is processed as if it appeared in place of the include declaration.

Rules cannot be split by an include declaration. An include declaration always ends the rule that appears before it, so part of a rule cannot be defined by including a file containing only actions. Similarly, if a rule's definition starts inside an included file, the definition ends with the end of the included file.

An include declaration can appear anywhere in an OmniMark program. Files inserted by include declarations can contain include declarations. The maximum nesting depth of include declarations is 100.

Rules and declarations appearing in an include file must be allowed where the include declaration occurs. For example, an escape declaration can only appear in an include if that include declaration occurs at the start of a program.

An included file must not include itself.