ZBasic Language Reference
159
ZBasic Microcontrollers
--use-batch-file
For native mode devices, this option causes the compiler to generate a batch file containing commands to
perform the back-end compile-link process instead of building using a makefile.
--verbose
This option, useful only for native mode devices, causes the output from the final build process to be sent
to stderr. In the absence of this option, the output from the build process is captured in a file named
build.log created in the temporary directory. (Use the –-keep-files option to prevent the build log
from being deleted after the build is complete.)
--version
This option causes the version number of the compiler to be sent to stdout. The compiler will then exit.
--warn=<warning-type>[,<warning-type>...]
This option enables or disables specific types of warnings. The warning types are described in the table
below. To disable a warning type, add the prefix no- to the warning type, e.g. no-unused-param. All
warnings may be disabled en masse using –-warn=no-warnings.
Warning Type
Number Description
array-bounds
9
Warn about constant indices on arrays being outside of the valid
range.
calltask-byref
1
Warn about invoking a task that uses ByRef parameters.
case-overlap
10
Warn about the same value appearing in more than one case
expression or range in a Select Case statement.
data-range
3
Warn about data values exceeding the capacity for the specified
type.
for-loop-termination
11
Warn about a For loop that may not terminate properly.
hidden-data
5
Warn about data definitions hiding definitions at outer levels.
never-returns
8
Warn that a routine will never return (automatically suppressed
for the entry routine and routines invoked using CallTask).
questionable-code
4
Warn about questionable coding practices.
structure-compare
12
Warn about comparison of structures containing allocated
strings.
task-stack-size
13
Warn about insufficient task stack size.
undefined-variable
2
Warn about the use of a variable before a value is assigned to it
or when at least one path through a function does not set the
return value.
unused-parameter
6
Warn about an unused parameter.
unused-procedure
14
Warn about an unused procedure.
useless-code
7
Warn about code that will never be executed or has no effect.
warnings
1000
Refers to all warning types collectively.
The invocation option –-help-warning displays similar information and also indicates which warning
types are on by default.
--warning-is-error
This option causes the compiler to treat all warnings as errors.
-D<id>[=<value>]
 |
 |
 |