User manual

Project creation and build UM0036
136/385 Doc ID 7705 Rev 11
When the Category list box is set to General, the standard listing options are:
● C and Assembler Listing: Adds -Lasm option to the command line. The output is
filename.lst.
● No Listing
● List of Include Files: Adds -Li option to the command line. The output is
filename.inc.
● Preprocessor Output: Adds -Lp option to the command line, which generates a text
file containing the preprocessor output. The output is filename.pre.
● Customize: Allows you to choose the Listing options you want (options are
summarized in Customizing Metrowerks C compiler listings on page 141).
C Language
The Compiler C language settings allow you to define the programming language options to
apply while compiling the application.
When the Category list box is set to General, the standard language options are:
● Default: No option in the command line. The compiler accepts ANSI standard
keywords and some non-ANSI compliant keywords, including: @address, far, near,
rom, uni, _alignof_, _va_sizeof_, interrupt and asm.
● Strict ANSI Checking: Introduces -Ansi option in the command line, which restricts
the compiler to recognition of ANSI standard keywords.
● Customize: Allows you to choose from the C language options that are listed in
Customizing Metrowerks C compiler language settings on page 143. For complete
descriptions of options, refer to Metrowerks STMicroelectronics ST7 Compiler user
manual.
“Do not use environment” option (-NoEnv)
This checkbox enables and disables the no environment option (-NoEnv) in the startup
routine. This option is specified independently for the assembler (see Section 4.9.2:
Metrowerks Assembler tab on page 143) and the linker (see Section 4.9.3: Metrowerks
linker tab on page 148).
When checked in the C compiler tab, the -NoEnv option is applied to the compiler command
line. This option is checked by default so the compiler uses environment variables specified
by options.
Uncheck this option if you want to use an environment file (such as default.env) to
specify environment variables for the C compiler. The environment file should be located in
the current directory.
Preprocessor definitions
This field allows you to enter user-specified macros for the preprocessor. The compiler
allows the definition of a macro in the command line. The effect is the same as having a
#define directive at the beginning of the source file.
When entering definitions, the -d option is automatically added to the command line as you
type the symbol. When you enter several definitions, separate them with a space and -d will
automatically be added to the next symbol in the command line.