SLAU132V October 2004 – February 2020
The --gen_preprocessor_listing option generates a raw listing file that can help you understand how the compiler is preprocessing your source file. Whereas the preprocessed listing file (generated with the --preproc_only, --preproc_with_comment, --preproc_with_line, and --preproc_dependency preprocessor options) shows a preprocessed version of your source file, a raw listing file provides a comparison between the original source line and the preprocessed output. The raw listing file has the same name as the corresponding source file with an .rl extension.
The raw listing file contains the following information:
Each source line in the raw listing file begins with one of the identifiers listed in Table 2-32.
Identifier | Definition |
---|---|
N | Normal line of source |
X | Expanded line of source. It appears immediately following the normal line of source if nontrivial preprocessing occurs. |
S | Skipped source line (false #if clause) |
L | Change in source position, given in the following format:
L line number filename key |
Where line number is the line number in the source file. The key is present only when the change is due to entry/exit of an include file. Possible values of key are: | |
1 = entry into an include file
2 = exit from an include file |
The --gen_preprocessor_listing option also includes diagnostic identifiers as defined in Table 2-33.
Diagnostic Identifier | Definition |
---|---|
E | Error |
F | Fatal |
R | Remark |
W | Warning |
Diagnostic raw listing information is displayed in the following format:
Sfilenameline numbercolumn numberdiagnostic |
S | One of the identifiers in Table 2-33 that indicates the severity of the diagnostic |
filename | The source file |
line number | The line number in the source file |
column number | The column number in the source file |
diagnostic | The message text for the diagnostic |
Diagnostic messages after the end of file are indicated as the last line of the file with a column number of 0. When diagnostic message text requires more than one line, each subsequent line contains the same file, line, and column information but uses a lowercase version of the diagnostic identifier. For more information about diagnostic messages, see Section 2.7. |