User manual

UM0036 Project creation and build
Doc ID 7705 Rev 11 149/385
Output filename options
Allows you to specify the name for the output file. It appears in the command line preceded
by the option -O.
Optimizations
The Optimization settings allow you to optimize your code once you have finished
debugging your application, in order to make the final version more compact and faster. You
should not optimize your code when debugging as some optimizations will eliminate or
ignore the debug information required by STVD and your debug instrument.
When category is set to General, the standard optimization options are:
● Priority is to Fill Banks: This option minimizes the occurrence of partially filled blocks
of banks. This option adds the -DistOptiFillBanks option in the command line.
Used in generation of ELF files only.
● Priority is to Minimize Code Size: This option gives priority to minimizing the code
size over the memory fill optimization. The -DistOptiCodeSize option is added to
the command line. Used in generation of ELF files only.
● Disable (For Debugging): No optimizations, no option in the command line.
● Customize: Allows you to choose the options that you want for optimization (options
are summarized in Customizing Metrowerks linker optimization settings on page 151)
Note: The Metrowerks toolset outputs files in ELF format and a Hiware proprietary format. The
optimization options above are for ELF format. Hiware optimizations are listed in Table 54 .
Message display
This allows you to determine what messages are displayed in the Build tab of STVD’s
Output window. The display options include:
● Only Errors (-W2 in the command line)
● Errors + Warnings (-W1)
● Errors + Warnings + Info (-Wmsg)
Output
The Output settings allow you to define listings and other output for the linker to generate.
When category is set to General, the standard output options are:
● All Listings (Map + Statistics + Errors): This option generates linker statistics in a
text file (statistic.txt), in addition to map and error listings. This option adds the
-M and -StatF=statisti.txt options in the command line.
● No listing: No listing generated, no option in the command line.
● Customize: Allows you to choose the options that you want for optimization (options
are summarized in Customizing Metrowerks linker output settings on page 152)
Strip debug information
Check the Strip Debug Info checkbox to remove debug information when you are
generating the release version of your application. Introduces the -S option in the command
line.