ZBasic Language Reference
114
ZX Microcontroller Family
--called-by-list
When this option is specified a called-by list is appended to the map file. The called-by list will indicate,
for each subroutine or function, each routine that invokes it. This information may be useful in analyzing
the impact of changes in your code. If no map file is generated this option is ignored.
--calls-list
When this option is specified a calls list is appended to the map file. The calls list will indicate, for each
subroutine or function, each routine that it invokes. This information may be useful in analyzing the
impact of changes in your code. If no map file is generated this option is ignored.
--code-limit=<value>
This option requests that the compiler compare the size of the generated code with the specified limit
value. The limit value is specified in decimal, optionally using the suffix K or k to denote a multiple of
1024 bytes. If the code size exceeds the limit an error message will be generated. The default code limit
is 0, which value disables the code size checking.
--create-library[=<file>]
This option, useful only for native mode devices, requests that the compiler build an object code archive
(object library) instead of building an executable file. If the library filename is not specified, the library file
will have the name of the project file or the first module processed with the extension replaced by .a.
The compiler will also create an additional file containing ZBasic declarations for all of the public entities
in the library. The declarations file will have the same name as the library with the extension replaced by
.inc.
--directory=<path>
This option specifies a directory that should be made the current directory. Any filename that has a
relative path prefix will be sought relative to the current directory (but see -include-path, below). For
example, since the filename ir\test.bas is a relative filename it will be expected to be in the current
directory. In contrast, a file specified with an absolute filename like c:\projects\ir\test.bas will
not.
--entry=<subroutine>
This option specifies an alternate entry point for the program. By default, the entry point is the subroutine
Main().
--error=<file>
This option explicitly specifies the name for the error output file. In the absence of this option, the error
output is sent to stderr. Depending on your operating system, you may have the ability to redirect stderr
to a file.
--error-format[=<format-spec>]
This option explicitly specifies the format that should be used for outputting error messages. If the equal
sign and format specification are missing, use of the default format specification will be resumed. The
error format string specifies the string that precedes the descriptive error message. The format string