5.5 Directives that Format the Output Listings

These directives format the listing file:

• The .drlist directive causes printing of the directive lines to the listing; the .drnolist directive turns it off for certain directives. You can use the .drnolist directive to suppress the printing of the following directives. You can use the .drlist directive to turn the listing on again.

.asg .break .emsg

.eval .fclist .fcnolist

.length .mlist .mmsg

.mnolist .sslist .ssnolist

.var .width .wmsg

• The source code listing includes false conditional blocks that do not generate code. The .fclist and .fcnolist directives turn this listing on and off. You can use the .fclist directive to list false conditional blocks exactly as they appear in the source code. You can use the .fcnolist directive to list only the conditional blocks that are actually assembled.
• The .length directive controls the page length of the listing file. You can use this directive to adjust listings for various output devices.
• The .list and .nolist directives turn the output listing on and off. You can use the .nolist directive to prevent the assembler from printing selected source statements in the listing file. Use the .list directive to turn the listing on again.
• The source code listing includes macro expansions and loop blocks. The .mlist and .mnolist directives turn this listing on and off. You can use the .mlist directive to print all macro expansions and loop blocks to the listing, and the .mnolist directive to suppress this listing.
• The .option directive controls certain features in the listing file. This directive has the following operands:

	A	turns on listing of all directives and data, and subsequent expansions, macros, and blocks.
	B	limits the listing of .byte and .char directives to one line.
	D	turns off the listing of certain directives (same effect as .drnolist).
	H	limits the listing of .half and .short directives to one line.
	L	limits the listing of .long directives to one line.
	M	turns off macro expansions in the listing.
	N	turns off listing (performs .nolist).
	O	turns on listing (performs .list).
	R	resets the B, H, L, M, T, and W directives (turns off the limits of B, H, L, M, T, and W).
	T	limits the listing of .string directives to one line.
	W	limits the listing of .word and .int directives to one line.
	X	produces a cross-reference listing of symbols. You can also obtain a cross-reference listing by invoking the assembler with the --asm_listing_cross_reference option (see Section 4.3).

• The .page directive causes a page eject in the output listing.
• The source code listing includes substitution symbol expansions. The .sslist and .ssnolist directives turn this listing on and off. You can use the .sslist directive to print all substitution symbol expansions to the listing, and the .ssnolist directive to suppress this listing. These directives are useful for debugging the expansion of substitution symbols.
• The .tab directive defines tab size.
• The .title directive supplies a title that the assembler prints at the top of each page.
• The .width directive controls the page width of the listing file. You can use this directive to adjust listings for various output devices.