For an output file:
  file (with open-modifier (& open-modifier)*)*

  For a source file:
  (binary-mode | text-mode)?  file string-expression

The operator file retrieves the contents of a named file.

Usually, OmniMark will read the file in its entirety and use the whole content in a single string expression. This can require large amounts of computer memory.

In certain limited cases, the file can be read in smaller chunks, allowing very large files to be processed without requiring huge amounts of computer memory. These cases occur whenever the file expression is used in the string expression of any of the following actions alone, or attached by join to other string expressions:

• put (the file expression must be the second argument)
• output
• set (when performed on a stream)
• set file
• set referent

file can also be used as the entire string expression argument of one of the following actions:

• submit
• do scan
• repeat scan
• do sgml-parse
• do xml-parse