2.2 Compiler Options

-v, --verbose

Display all compiler messages

-q, --quiet

Inhibit compiler messages

-M, --makedepend

Instead of executing, write a list of dependencies to stdout

-o FILE, --outputfile=FILE

Write output to FILE (- for stdout)

--execheader=STRING

When invoked with option -x the compiler first outputs a header so that the output file may be interpreted by the operating system as an executable. Under Unix, the default behaviour is to use the following as header:

#!/bin/sh 
exec ozengine $0 "$@"

The --execheader option allows you to specify a different header.

--execpath=STRING

Uses the header given above in the description of --execheader, except that ozengine is replaced by STRING.

--execfile=FILE

Reads in FILE and uses this as header. Under Windows, the default behaviour is to use the file provided in ozhome/bin/ozwrapper.bin, where ozhome is Mozart's installation folder. ozwrapper.bin is a Windows executable that launches ozengine.

--execwrapper=FILE

Reads in ozhome/bin/FILE and uses it as header for executable files. Apart from ozwrapper.bin, an ozwrapperw.bin is supplied that launches ozenginew instead of ozengine. This option provides a convenient way to use this alternative wrapper.

-z N, --compress=N

Pickles may be written in a compressed format. By default they are not compressed. -z N selects a compression level: N is an integer between 1 and 9. Compressing a pickle may improve loading/downloading time.

-D NAME, --define=NAME

Define macro NAME. Code source may have \ifdef NAME conditional directives that tests whether macro NAME is defined.

-U NAME, --undefine=NAME

Undefines macro NAME

-l MODULES, --environment=MODULES

ozc -l Baz=$HOME/baz.ozf -c Foo.oz

Makes MODULES, a comma-separated list of pairs VAR=URL, available in the environment. For each VAR=URL, the module available through the functor at URL is obtained and VAR is bound to it. The file Foo.oz being compiled can then reference variable VAR.

-I DIR, --incdir=DIR

Adds DIR to the head of OZPATH which is used to locate files to \insert.

--include=FILE

Compile and execute the statement in FILE before processing the remaining options. This can be used e. g. to extend the compilation environment by executing a declare.

--maxerrors=N

Limit the number of errors reported to N.

--baseurl=STRING

Set the base URL to resolve imports of computed functors to STRING.


Denys Duchier, Leif Kornstaedt and Christian Schulte
Version 1.1.0 (20000207)