Typically, you use raw listing information to generate a formatted listing. The raw listing
file contains raw source lines, information on transitions into and out of include files,
and diagnostics generated by the compiler. Each line of the listing file begins with any of
the following key characters that identifies the type of line:
A normal line of source. The rest of the line is the text of the line of
The expanded form of a normal line of source. The rest of the line is the text of
the line. This line appears following the
N line, and only if the
line contains nontrivial modifications. Comments are considered trivial modifications,
and macro expansions, line splices, and trigraphs are considered nontrivial
modifications. Comments are replaced by a single space in the expanded-form
A line of source skipped by an
#if or similar. The rest of the
line is text.
that ends a skip is marked with an
Indicates a change in source position. That is, the line has a format similar to
# line-identifying directive output by the preprocessor:
For entry into an include file.
For exit from an include file.
is omitted. The first line in the
raw listing file is always an
L line identifying the primary input
L lines are also output for
indicate the source position of the following source line in the raw listing
Indicates a diagnostic, where:
Indicates a remark.
Indicates a warning.
Indicates an error.
The line has the form:
Errors at the end of file indicate the last line of the primary source file and a
column number of zero.
Command-line errors are errors with a filename of
line>". No line or column number is displayed as part of the error
Internal errors are errors with position information as usual, and message-text
When a diagnostic message displays a list, for example, all the contending routines
when there is ambiguity on an overloaded call, the initial diagnostic line is followed
by one or more lines with the same overall format. However, the code letter is the
lowercase version of the code letter in the initial line. The source position in these
lines is the same as that in the corresponding initial line.