ZBasic Language Reference
147
ZBasic Microcontrollers
--device-parameter=<name>,<value>
This option specifies the value for a target device parameter (useful only for generic target devices). See
Section 5.3 for a complete list of device parameter names and the expected values.
--directory[=<path>]
This option specifies a directory that should be made the “current directory”. If the option is given without
a specific directory, the directory is inferred from the project or arguments file being processed at the time.
If no project or arguments file is being processed, from which the directory can be inferred, the option is
silently ignored.
Generally, a 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 ir sub-directory of 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
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.
 |
 |
 |