ZBasic Language Reference
115
ZX Microcontroller Family
may contain ordinary characters and escape sequences. The supported escape sequences are
described in the table below.
Error Format Specification Escape Sequences
Escape
Description
%f
The file containing the error.
%l
The line number on which the error occurred.
%%
A literal percent sign (only needed to disambiguate).
The format specification may be enclosed in matching quote marks or apostrophes but this is necessary
only if the format specification contains spaces. The default format specification is "%f:%l:". This
causes messages to have the format required by the IDE for error file navigation.
--error-limit=<value>
This option specifies an upper limit on the number of error messages that will be generated. When the
limit is exceeded, compilation will cease. The default error limit is 100.
--gcc-opts=<options>
This option allows you to specify additional options to be passed to the gcc compiler and linker when
generating code for native mode devices. The option string given will be added to the command lines
after the options supplied by the ZBasic compiler and before the filenames. This position allows you to
override earlier options or to add to the options or both.
--heap-limit=<value>
This option, useful only for native mode devices, specifies the heap limit, beyond which the heap will not
grow. See the discussion in section 4.6 for details on the effect of this option.
--heap-size=<value>
This option, useful only for native mode devices, specifies the size of the heap and, indirectly, the heap
limit. See the discussion in section 4.6 for details on the effect of this option.
--help
This option causes the compiler to output a summary of the invocation options and then exit.
--help-all
This option causes the compiler to output more comprehensive information about the invocation options
and then exit.
--help-optimize
This option causes the compiler to output information about available optimization flags and default
settings, and then exit.