Microchip Technology XC8 Standard Compiler (Workstation) SW006021-1 SW006021-1 User Manual

®

DS52053B-page 266

 2012 Microchip Technology Inc.

6.4.10.1

ASMOPT_OFF AND ASMOPT_ON

These controls allow the assembler optimizer to be selectively disabled for sections of 
assembly code. No code will be modified after an ASMOPT_OFF control, until a subse-
quent ASMOPT_ON control is encountered.

6.4.10.2

COND

Any conditional code will be included in the listing output. See also the NOCOND control 
in Section 6.4.10.6 “NOCOND”.

6.4.10.3

EXPAND

When EXPAND is in effect, the code generated by macro expansions will appear in the 
listing output. See also the NOEXPAND control in Section 6.4.10.7 “NOEXPAND”.

6.4.10.4

INCLUDE

This control causes the file specified by pathname to be textually included at that point 
in the assembly file. The INCLUDE control must be the last control keyword on the line, 
for example:

OPT INCLUDE "options.h"

The driver does not pass any search paths to the assembler, so if the include file is not 
located in the working directory, the pathname must specify the exact location.

See also the driver option -P in Section 4.8.11 “-P: Preprocess Assembly Files” 
which forces the C preprocessor to preprocess assembly file, thus allowing use of 
preprocessor directives, such as #include (see Section 5.14.1 “C Language 
Comments”).

6.4.10.5

LIST

If the listing was previously turned off using the NOLIST control, the LIST control on its 
own will turn the listing on.

Alternatively, the LIST control may includes options to control the assembly and the 
listing. The options are listed in Table 6-8.

See also the NOLIST control in Section 6.4.10.8 “NOLIST”.

c=

 nnn

80

Set the page (i.e., column) width.

n=

 nnn

59

Set the page length.

t=

 ON|OFF

OFF

Truncate listing output lines. The default wraps 
lines.

p=<

 device >

n/a

Set the device type.

r=<

 radix >

HEX

Set the default radix to HEX, dec or oct.

x=

 ON|OFF

OFF

Turn macro expansion on or off.