NSASM User Manual: COP8 Assembly Tools Documentation
PrevNext

II. Assembler Options and Controls

This section describes the controls that may be used in the source program on a control line or used on the invocation line as an option. The syntax of their usage as an option is described in Section 2.2.2.

A control line is indicated by a # in column 1 of the source line, followed by any of the following controls separated by white space. Comments may be included on a control line by using a semicolon followed by the comment. The ";" terminates the control line.

A control name may be abbreviated to the number of letters shown in capital letters in the descriptions. For example, MASTERLIST may be also specified as MASTER, MA, or even M. However, MC gives an error, since it is uncertain whether MCALLS or MCOMMENTS is wanted. Many of the controls may also have the prefix NO. In this case, the rest of the name may be abbreviated as normal. Control names are not case sensitive.

A control may be classified as primary, general or invocation line only. Primary controls are those that can be set only on the invocation line or at the beginning of the program before any other statements, except for other control lines or comments. General controls may be specified anywhere and can be re-specified at any time. Thus, the usual source program structure is: 

	#MASTERLIST ;general is okay up here

	; comment okay between primary controls

	#HEADINGS ;turn on headings

	; instruction follows

	NOP

	; at this point only general controls will be valid

A few of the controls are shown as "invocation line only." This, of course, means they are valid only on the program invocation line and cannot be used within the program.

A general control may be saved and restored by the SAVE and RESTORE controls.

Invocation line controls are masters and override the same control in the program source. Thus, NOMASTERLIST on the invocation line overrides #MASTERLIST in the source.

Assembler controls and functions, described in this section, are summarized in Table 2-8.

Table of Contents
aserrorfile --  creates a copy of the source file with error messages added
chip --  specifies the member of the COP8 family
cnddirectives --  controls the listing of conditional directives
cndlines --  controls the listing of lines that are not assembled because of conditional assembly
commenentlines --  controls the listing of comment lines
complexrel --  controls the use of complex relocation
constants --  controls whether constants symbol information is kept for debugging purposes
crossref --  adds a cross reference table to the listing file
datadirectives --  controls the display of data directives in the listing file
define --  defines a symbol to be used in the source program
echo --  controls whether command files (@file) are echoed
errorfile --  controls the creation of an error file
formfeed --  controls the page breaks in the listing file
headings --  controls the heading of the listing file
ilines --  controls the listing of include files
include --  specifies a path to search for include files
listfile --  controls the generation of a listing file
localsymbols --  controls whether local symbol information is save for debugging purposes
masterlist --  controls whether source lines are listed in the listing file
mcalls --  controls the listing of macro calls
mcomments --  controls the listing of macro comments
mdefinitions --  controls the listing of macro definitions
memory --  allows for less PC RAM usage
mexpansions --  controls whether the whole macro is shown or just the call
mlocal --  controls whether local macro symbols are included in the cross reference table.
mobject --  lists macros even if they don't generete code
model --  specifies the memory model
numberlines --  controls how listing file lines are numbered
objectfile --  controls the generation of an object file
pass --  controls the number of passes through the source code that the assembler should perform
plength --  controls the listing file page length
pwidth --  controls the listing file page length
quick --  speeds up the assembly process by not generating some output files
remove --  removes the error strings added by aserrorfile
restore --  restores the control flags saved by save
save --  saves the state of some options
signedcompare --  controls the arithmetic used when evaluating expressions for contional operators
sizesymbol --  controls the maximum size for a symbol
sym_debug --  controls the source line and symbolic debugging
tablesymbols --  controls the listing of a symbol table
tabs --  controls the display of tab characters
undefine --  undefines a symbol defined by define
uppercase --  controls the case of symbols and opcodes
verify --  creates a listing file for each pass of the assembler
warnings --  controls the output of warnings messages
xdirectory --  controls how directory are searched for include files
PrevHomeNext
.wordUpaserrorfile