Page 155 of 229 Start Back Next End ZBasic Language Reference 145 ZBasic Microcontrollers --out=<file> -fo<file> Specify an output file for generated code. --overload Enable procedure overloading. --project=<file> -fp<file> Specify a project to be processed. --strict={on|off|default} *Specify the compilation mode. --string-size=<value> -s<value> *Specify the default string size. --target-config[=<file>] --target-config-force[=<file>] *Specify inclusion of a target configuration file. --target-device=<target> *Specify the target for code generation. --temp-dir=<directory> Specify the directory for intermediate files. --use-batch-file Use a batch file for native mode builds. --verbose Display output of the build process. --version Display the version number of the compiler. --warn=<warn-type> -w<warn-type> *Enable or disable warnings by type. --warning-is-error *Treat all warnings as errors. -D<id>[=<value>] *Define conditional symbol with optional value. -U<id> *Undefine a conditional symbol. The options are described in detail in the next section, ordered alphabetically by the long form name followed by those options that have no long form. 10.2 Compiler Options in Detail --alloc-str={On|Off|Default} This option specifies whether dynamically allocated string usage should be on, off or set to the default state for the selected language. See Section 2.3.1 for more information on the default state of this option for the supported language variants. --allow-conditionals This option activates support for using #if conditionals in project and argument files. Because of the fact that a pound sign introduces a comment in both of these types of files, support for conditionals in them is disabled by default. Alternately, you can enable support for conditionals in specific project or argument files by adding a special comment having the format shown below as the first line of the file. #!allow-conditionals --api[(<width>)][=<file>] Using this option you can request that the compiler generate an API file for use by the IDE to display “call tips” for the routines in your program. If the =<file> is not present, the output is written to a file having the same base name as the first project file specified or, if none, the first module compiled, but with the extension “.api”. For example, if the project is myproj.pjt, the default API file will be myproj.api. The optional <width> parameter, which must be enclosed in parentheses, specifies a nominal line width for the generated API definitions. A special line break character is inserted near multiples of the specified width to allow the IDE to display long call tips on multiple lines. The width used if none is explicitly specified is 80. --args=<fil e> You can use this option to specify the name of a file that contains additional compiler options and/or filenames, one per line. The content of the file is processed before processing additional command line options. Such argument files may not be nested but a project file may be specified within an arguments