ZBasic Language Reference
149
ZBasic Microcontrollers
--keep-files
This option requests that the compiler not delete the intermediate files that it creates during compilation.
This is only useful for native mode devices. Unless otherwise specified (using the –-temp-dir option),
the intermediate files will be created in a subdirectory named zbTempDir in the same directory as the
project file.
--language=<language>
This option specifies the target language for the modules subsequently processed. The values that may
be specified for the <language> element are shown in the table below.
Language Option Values
Value
Description
BasicX
Compile using BasicX compatibility mode.
ZBasic
Compile using native mode (the default).
--list[=<file>]
This option requests that a listing file be generated and specifies the filename for it. For VM mode
devices, the listing file is similar to an assembly language listing, giving detailed information about the
code that was generated. If the equal sign and filename are omitted, the listing is output to stdout. For
native mode devices, the –-list option causes an actual assembly listing to be produced (--keep-
files is also needed, q.v.) and in this case no filename should be specified. The listing file will have and
extension of .lss.
--main-task-stack-size=<value>
This option, useful only for native mode devices, specifies the size of the stack for the Main() task and,
indirectly, the heap limit. See the discussion in section 6.6 for details on the effect of this option.
--map=<file>
This option explicitly specifies the name for the map file. In the absence of this option, the map file name
is derived from either the project file, if specified, or the first file compiled. If an earlier or later option
specifies no map file should be generated this option is ignored. Currently, no map file is generated for
native mode devices.
--namespaces
This option enables definition and use of namespaces. This option is implied by –-objects.
--name-style=<name-style>
This option specifies the identifer style that will be accepted. The default name style is c and the sole
alternative is Basic.
--no-analyze-stack-use
When this option is specified, the compiler will not perform an analysis of the tasks in your application to
determine the minimum stack size required. Consequently, you must make your own determination of the
proper task stack sizes by whatever means is appropriate.
 |
 |
 |