Formatting The Output Listing - Texas Instruments TMS320C54x User Manual

5.8 Formatting the Output Listing

Macros, substitution symbols, and conditional assembly directives may hide
information. You may need to see this hidden information, so the macro
language supports an expanded listing capability.
By default, the assembler shows macro expansions and false conditional
blocks in the output list file. You may want to turn this listing off or on within your
listing file. Four sets of directives enable you to control the listing of this
information:
-
Macro and Loop Expansion Listing
.mlist expands macros and .loop/.endloop blocks. The .mlist
directive prints all code encountered in those blocks.
.mnolist suppresses the listing of macro expansions and .loop/
.endloop blocks.
For macro and loop expansion listing, .mlist is the default.
-
False Conditional Block Listing
.fclist causes the assembler to include in the listing file all
conditional blocks that do not generate code (false condi-
tional blocks). Conditional blocks appear in the listing exactly
as they appear in the source code.
.fcnolist suppresses the listing of false conditional blocks. Only the
code in conditional blocks that actually assemble appears in
the listing. The .if, .elseif, .else, and .endif directives do not
appear in the listing.
For false conditional block listing, .fclist is the default.
-
Substitution Symbol Expansion Listing
.sslist expands substitution symbols in the listing. This is useful for
debugging the expansion of substitution symbols. The ex-
panded line appears below the actual source line.
.ssnolist turns off substitution symbol expansion in the listing.
For substitution symbol expansion listing, .ssnolist is the default.
-
Directive Listing
.drlist causes the assembler to print to the listing file all directive
lines.
.drnolist suppresses the printing of the following directives in the list-
ing file: .asg, .eval, .var, .sslist, .mlist, .fclist, .ssnolist,
.mnolist, .fcnolist, .emsg, .wmsg, .mmsg, .length, .width, and
.break.
For directive listing, .drlist is the default.
Formatting the Output Listing
Macro Language 5-21