General

A header file must be specially prepared to generate the assembler include file.

Listing: A pragma anywhere in the header file can enable assembler output
#pragma CREATE_ASM_LISTING ON 

Only macro definitions and declarations behind this pragma are generated. The compiler stops generating future elements when #pragma CREATE_ASM_LISTING: Create an Assembler Include File Listing occurs with an OFF parameter.

#pragma CREATE_ASM_LISTING OFF

Not all entries generate legal assembler constructs. Care must be taken for macros. The compiler does not check for legal assembler syntax when translating macros. Put macros containing elements not supported by the assembler in a section controlled by #pragma CREATE_ASM_LISTING OFF.

The compiler only creates an output file when the -La option is specified and the compiled sources contain #pragma CREATE_ASM_LISTING ON.