| Table of Contents |

Command-line options

The command-line options for OmniMark Desktop Compiler are listed below. Many command line options have short forms.

Options for compiling OmniMark programs

• To specify the file containing the OmniMark source script, use one of the following
  • -s sourcefile.xom
  • -source sourcefile.xom
  • -src sourcefile.xom
• To specify the OmniMark source program and to suppress printing of the identification banner, use one of the following:
  • -sb sourcefile.xom
  • -sourcebrief sourcefile.xom
• To compile a program from stdin (for example, your keyboard) use the following:
  • -term any-file.txt
  where any-file.txt is a dummy file that can be any file you choose, and will not be included in your compiled OmniMark application.
• To specify the name of your compiled OmniMark script when you compile, use one of the following:
  • -save compiledfile.xvc
  • -csc compiledfile.xvc

Controlling warnings

The OmniMark compiler produces warnings in the following catagories:

• ambiguity: A statement is potentially ambiguous. The compiler may not have interpreted the statement in the way you intended.
• deprecated: The keyword you used is deprecated. You should use the modern equivalent.
• dead-code: A section of code cannot be reached when your program is executed.
• pattern: A pattern can match zero characters.
• redundancy: The same declaration or modifier (or equivalent) is used more than once. OmniMark will ignore the duplicates.
• uninitialized-data-access: A shelf isn't explicitly initialized or assigned any value anywhere, but its value is used.

By default, the OmniMark compiler will display all these classes of warnings except for uninitialized-data-access. You can change how each class of error is handled using the following command line options:

• To promote the class of warnings to an error:
  • -warning-error warning-class
• To ignore the class of warnings:
  • -warning-ignore warning-class
• To report the error and continue compiling:
  • -warning-report warning-class

The -warning and -warnings command line options used in previous version of OmniMark no longer have any effect on the compiler.

Other command line options

• To generate a licence request key (for Unix users), which OmniMark Desktop Compiler will write to standard output:

  • -reqkeygen "SN-Yy3X-ptdi-gpa-u[4" [email protected] "Machine Sol23"

• To suppress printing of the identification banner, specify:
  • -brief
• To expand macros to log file, specify:
  • -expand
• To use a command-line arguments file, specify one of the following:
  • -f filename
  • -argsfile filename
  For details on creating and using arguments files, see the Using arguments files section.
• To show a function-call trace, specify:
  • -ftrace
• To print a brief on-line help message from the command line and exit, specify:
  • -help
• To specify a path to the include files, use one of the following:
  • -i path
  • -include path
• To set a maximum number of allowed error messages, specify:
  • -limit number
  • -threshold number
• To force OmniMark Desktop Compiler to ignore include paths specified in environment variables and Windows registry entries, specify:
  • -noenvarg
  • -noea
• To specify a file to which OmniMark Desktop Compiler will write log messages generated by the compilation process, specify one of the following:
  • -log testprogram.log (to overwrite existing log file)
  • -alog testprogram.log (to append to the existing log file)
• To display compile-time statistics, specify:
  • -stats
• To display the version of OmniMark Desktop Compiler, specify:
  • -version
• To display the authorization key for your OmniMark Desktop Compiler, specify:
  • -authkey
• To suppress the message output at the end of program execution giving the number of reported markup error and warning messages, specify:
  • -nocount

  OmniMark 8.0 beta 7
  EUM101-0605, generated: October 19, 2005 at 04:35:42 pm
  If you have any comments about this section of the documentation, send email to [email protected]