User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 145/385
Message display
With the category set to General, you can choose what types of messages the Assembler
will generate. These are the same command line options as those used by the compiler.
For a brief description of these options, refer to Message Display on page 135.
Output
With the category set to General, you can choose the format of the object file that the
Assembler will generate. You can choose from:
● ELF/DWARF 2.0: Adds the -F2 option to the command line, which causes the
assembler to generate object files in ELF/Dwarf 2.0 format.
● Hiware: Adds the -Fh option to the command line, which causes the assembler to
generate object files in Hiware proprietary format. If you change the output setting to
Hiware, STVD warns you that you must specify the PRM file to use in the Linker PRM
File settings of the Linker tab (see Configuring the Metrowerks linker PRM file on
page 153).
Note: We strongly recommend using the ELF/DWARF 2.0 format to build your application. This
gives you access to a greater range of toolset options. The Hiware format continues to be
supported for reasons of legacy compatibility.
Listings
The Listing settings allow you to generate a listing file and to log errors to a file.
When category is set to General, the standard listing options are:
● Full Listing File: Inserts the -L option in the command line. By default, the full listing
contains expanded included files, as well as macro definition, call and expansion lines.
The output is filename.lst.
● No Listing
● Customize: Allows you to choose the Listing options that you want (options are
summarized in Customizing Metrowerks C compiler listings on page 141).
“Do not use environment” option (-NoEnv)
This checkbox enables and disables the no environment option (-NoEnv) in the startup
routine. This option can is specified independently for the C compiler (see Section 4.9.1:
Metrowerks C Compiler tab on page 133) and the linker (see Section 4.9.3: Metrowerks
linker tab on page 148).
When checked in the Assembler tab, the -NoEnv option is applied to the assembler
command line. This option is checked by default so that the assembler uses environment
variables specified by options in the project settings.
Uncheck this option if you want to use an environment file (such as default.env) to
specify environment variables for the assembler. The environment file should be located in
the current directory.
Extra include paths
This field allows you to enter multiple paths for directories to include when assembling the
application.