Comments

Comments inside a region generated with #pragma CREATE_ASM_LISTING ON are also written on a single line in the assembler include file.

Comments inside of a typedef, a structure, or a variable declaration are placed either before or after the declaration. They are never placed inside the declaration, even if the declaration contains multiple lines. Therefore, a comment after a structure field in a typedef is written before or after the whole typedef, not just after the type field. Every comment is on a single line. An empty comment (/* */) inserts an empty line into the created file.

See the following listing for an example of how C source code with its comments is converted into assembly.

Listing: C source code conversion to assembly



#pragma CREATE_ASM_LISTING ON
/*

   The main() function is called by the startup code.

   This function is written in C. Its purpose is

   to initialize the application. */

void main(void);

/*

  The SIZEOF_INT macro specified the size of an integer type

  in the compiler. */

typedef int SIZEOF_INT;

#pragma CREATE_ASM_LISTING OFF

Creates:

; The function main is called by the startup code.

; The function is written in C. Its purpose is

; to initialize the application.

                      XREF  main

;

;   The SIZEOF_INT macro specified the size of an integer type

;   in the compiler.

SIZEOF_INT_SIZE       EQU   $2