ZBasic Language Reference
151
ZBasic Microcontrollers
--notice={on|off}
Enable or disable output from #notice.
--no-analyze-stack-use
Suppress the estimation of task stack size.
--no-code
Suppress the generation of code.
--no-map
Suppress the generation of a map file.
--objects
Enable object-oriented extensions.
--optimize=<opt-type>
-o<opt-type>
*Assert or deassert optimization options.
--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.
 |
 |
 |