Navigation bar
  Start Previous page
 116 of 156 
Next page End 111 112 113 114 115 116 117 118 119 120 121  

110
arguments file.  Note that the current directory can be made part of the include path in the normal fashion
by using a single period to represent it.
Example
--include-path=..\includes;.;C:\projects\zbasic\files
This specifies an include path with three components.  When you use an include directive with a non-
absolute path like #include "lcd.bas", the first place that the compiler will look for lcd.bas is in the
includes sub-directory of the parent of the current directory.  If it is not found there, the compiler will
next look in the current directory because of the presence of the period.  Finally, the compiler will look in
the directory C:\projects\zbasic\files.  If the file could not be located in any of the directories of
the path, an error message will be issued.
--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 zxTempDir 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.  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.  Currently, no listing is generated
for native mode devices.
--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 4.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.
--no-code
This option causes the compiler to omit the code generation step.  By implication, no map file will be
generated either.  This may be useful if all you want is a syntax check.
Previous page Top Next page