LWTools: docs/manual/x229.html annotate

annotate docs/manual/x229.html @ 364:44270b66df3c

Add some compatibility ops Add compatibility opcodes for other assemblers. Thanks to Erik G <erik@6809.org> for the patch.

author	William Astle <lost@l-w.ca>
date	Mon, 01 Jun 2015 19:55:11 -0600
parents	507f442dc71e
children

rev	line source
333 507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	2 <HTML
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	3 ><HEAD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	4 ><TITLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	5 >Assembler Directives</TITLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	6 ><META
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	7 NAME="GENERATOR"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	9 REL="HOME"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	10 TITLE="LW Tool Chain"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	11 HREF="index.html"><LINK
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	12 REL="UP"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	13 TITLE="LWASM"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	14 HREF="c62.html"><LINK
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	15 REL="PREVIOUS"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	16 TITLE="Numbers and Expressions"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	17 HREF="x221.html"><LINK
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	18 REL="NEXT"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	19 TITLE="Macros"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	20 HREF="x520.html"></HEAD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	21 ><BODY
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	22 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	23 BGCOLOR="#FFFFFF"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	24 TEXT="#000000"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	25 LINK="#0000FF"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	26 VLINK="#840084"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	27 ALINK="#0000FF"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	28 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	29 CLASS="NAVHEADER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	30 ><TABLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	31 SUMMARY="Header navigation table"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	32 WIDTH="100%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	33 BORDER="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	34 CELLPADDING="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	35 CELLSPACING="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	36 ><TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	37 ><TH
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	38 COLSPAN="3"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	39 ALIGN="center"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	40 >LW Tool Chain</TH
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	41 ></TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	42 ><TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	43 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	44 WIDTH="10%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	45 ALIGN="left"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	46 VALIGN="bottom"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	47 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	48 HREF="x221.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	49 ACCESSKEY="P"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	50 >Prev</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	51 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	52 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	53 WIDTH="80%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	54 ALIGN="center"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	55 VALIGN="bottom"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	56 >Chapter 3. LWASM</TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	57 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	58 WIDTH="10%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	59 ALIGN="right"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	60 VALIGN="bottom"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	61 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	62 HREF="x520.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	63 ACCESSKEY="N"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	64 >Next</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	65 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	66 ></TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	67 ></TABLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	68 ><HR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	69 ALIGN="LEFT"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	70 WIDTH="100%"></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	71 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	72 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	73 ><H1
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	74 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	75 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	76 NAME="AEN229"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	77 >3.6. Assembler Directives</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	78 ></H1
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	79 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	80 >Various directives can be used to control the behaviour of the
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	81 assembler or to include non-code/data in the resulting output. Those directives
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	82 that are not described in detail in other sections of this document are
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	83 described below.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	84 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	85 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	86 ><H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	87 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	88 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	89 NAME="AEN232"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	90 >3.6.1. Data Directives</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	91 ></H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	92 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	93 ></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	94 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	95 CLASS="VARIABLELIST"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	96 ><DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	97 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	98 >FCB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	99 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	100 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	101 >, .DB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	102 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	103 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	104 >, .BYTE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	105 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	106 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	107 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	108 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	109 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	110 >Include one or more constant bytes (separated by commas) in the output.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	111 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	112 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	113 >FDB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	114 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	115 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	116 >, .DW <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	117 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	118 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	119 >, .WORD <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	120 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	121 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	122 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	123 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	124 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	125 >Include one or more words (separated by commas) in the output.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	126 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	127 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	128 >FQB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	129 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	130 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	131 >, .QUAD <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	132 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	133 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	134 >, .4BYTE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	135 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	136 >expr[,...]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	137 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	138 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	139 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	140 >Include one or more double words (separated by commas) in the output.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	141 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	142 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	143 >FCC <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	144 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	145 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	146 >, .ASCII <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	147 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	148 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	149 >, .STR <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	150 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	151 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	152 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	153 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	154 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	155 >Include a string of text in the output. The first character of the operand
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	156 is the delimiter which must appear as the last character and cannot appear
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	157 within the string. The string is included with no modifications></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	158 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	159 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	160 >FCN <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	161 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	162 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	163 >, .ASCIZ <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	164 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	165 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	166 >, .STRZ <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	167 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	168 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	169 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	170 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	171 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	172 >Include a NUL terminated string of text in the output. The first character of
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	173 the operand is the delimiter which must appear as the last character and
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	174 cannot appear within the string. A NUL byte is automatically appended to
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	175 the string.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	176 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	177 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	178 >FCS <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	179 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	180 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	181 >, .ASCIS <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	182 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	183 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	184 >, .STRS <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	185 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	186 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	187 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	188 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	189 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	190 >Include a string of text in the output with bit 7 of the final byte set. The
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	191 first character of the operand is the delimiter which must appear as the last
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	192 character and cannot appear within the string.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	193 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	194 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	195 >ZMB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	196 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	197 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	198 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	199 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	200 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	201 >Include a number of NUL bytes in the output. The number must be fully resolvable
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	202 during pass 1 of assembly so no forward or external references are permitted.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	203 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	204 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	205 >ZMD <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	206 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	207 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	208 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	209 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	210 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	211 >Include a number of zero words in the output. The number must be fully
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	212 resolvable during pass 1 of assembly so no forward or external references are
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	213 permitted.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	214 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	215 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	216 >ZMQ <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	217 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	218 >expr<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	219 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	220 ></CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	221 ></CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	222 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	223 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	224 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	225 >Include a number of zero double-words in the output. The number must be fully
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	226 resolvable during pass 1 of assembly so no forward or external references are
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	227 permitted.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	228 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	229 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	230 >RMB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	231 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	232 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	233 >, .BLKB <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	234 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	235 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	236 >, .DS <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	237 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	238 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	239 >, .RS <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	240 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	241 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	242 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	243 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	244 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	245 >Reserve a number of bytes in the output. The number must be fully resolvable
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	246 during pass 1 of assembly so no forward or external references are permitted.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	247 The value of the bytes is undefined.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	248 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	249 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	250 >RMD <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	251 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	252 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	253 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	254 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	255 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	256 >Reserve a number of words in the output. The number must be fully
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	257 resolvable during pass 1 of assembly so no forward or external references are
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	258 permitted. The value of the words is undefined.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	259 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	260 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	261 >RMQ <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	262 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	263 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	264 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	265 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	266 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	267 >Reserve a number of double-words in the output. The number must be fully
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	268 resolvable during pass 1 of assembly so no forward or external references are
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	269 permitted. The value of the double-words is undefined.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	270 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	271 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	272 >INCLUDEBIN <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	273 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	274 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	275 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	276 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	277 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	278 >Treat the contents of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	279 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	280 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	281 > as a string of bytes to
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	282 be included literally at the current assembly point. This has the same effect
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	283 as converting the file contents to a series of FCB statements and including
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	284 those at the current assembly point.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	285 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	286 > If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	287 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	288 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	289 > beings with a /, the file name
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	290 will be taken as absolute. Otherwise, the current directory will be
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	291 searched followed by the search path in the order specified.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	292 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	293 > Please note that absolute path detection including drive letters will
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	294 not function correctly on Windows platforms. Non-absolute inclusion will
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	295 work, however.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	296 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	297 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	298 >FILL <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	299 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	300 >size</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	301 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	302 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	303 >byte</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	304 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	305 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	306 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	307 >Insert <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	308 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	309 >size</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	310 > bytes of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	311 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	312 >byte</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	313 >.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	314 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	315 ></DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	316 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	317 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	318 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	319 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	320 ><H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	321 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	322 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	323 NAME="AEN343"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	324 >3.6.2. Address Definition</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	325 ></H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	326 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	327 >The directives in this section all control the addresses of symbols
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	328 or the assembly process itself.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	329 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	330 ></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	331 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	332 CLASS="VARIABLELIST"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	333 ><DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	334 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	335 >ORG <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	336 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	337 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	338 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	339 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	340 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	341 >Set the assembly address. The address must be fully resolvable on the
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	342 first pass so no external or forward references are permitted. ORG is not
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	343 permitted within sections when outputting to object files. For target formats
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	344 that include address information (decb, hex, srec, and ihex), an ORG
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	345 directive will re-start the address sequence within the output. When using
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	346 the raw target format, ORG is used only to determine the addresses of symbols.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	347 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	348 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	349 ><CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	350 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	351 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	352 > EQU <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	353 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	354 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	355 >, <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	356 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	357 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	358 > = <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	359 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	360 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	361 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	362 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	363 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	364 >Define the value of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	365 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	366 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	367 > to be <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	368 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	369 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	370 >.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	371 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	372 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	373 ><CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	374 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	375 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	376 > SET <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	377 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	378 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	379 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	380 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	381 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	382 >Define the value of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	383 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	384 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	385 > to be <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	386 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	387 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	388 >.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	389 Unlike EQU, SET permits symbols to be defined multiple times as long as SET
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	390 is used for all instances. Use of the symbol before the first SET statement
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	391 that sets its value is undefined.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	392 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	393 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	394 >SETDP <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	395 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	396 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	397 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	398 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	399 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	400 >Inform the assembler that it can assume the DP register contains
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	401 <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	402 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	403 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	404 >. This directive is only advice to the assembler
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	405 to determine whether an address is in the direct page and has no effect
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	406 on the contents of the DP register. The value must be fully resolved during
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	407 the first assembly pass because it affects the sizes of subsequent instructions.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	408 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	409 >This directive has no effect in the object file target.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	410 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	411 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	412 >ALIGN <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	413 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	414 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	415 >[,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	416 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	417 >value</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	418 >]</DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	419 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	420 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	421 >Force the current assembly address to be a multiple of
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	422 <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	423 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	424 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	425 >. If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	426 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	427 >value</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	428 > is not
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	429 specified, a series of NUL bytes is output to force the alignment, if
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	430 required. Otherwise, the low order 8 bits of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	431 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	432 >value</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	433 >
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	434 will be used as the fill. The alignment value must be fully resolved on the
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	435 first pass because it affects the addresses of subsquent instructions.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	436 However, <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	437 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	438 >value</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	439 > may include forward references; as
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	440 long as it resolves to a constant for the second pass, the value will be
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	441 accepted.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	442 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	443 >Unless <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	444 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	445 >value</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	446 > is specified as something like $12,
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	447 this directive is not suitable for inclusion in the middle of actual code.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	448 The default padding value is $00 which is intended to be used within data
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	449 blocks. </P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	450 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	451 ></DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	452 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	453 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	454 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	455 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	456 ><H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	457 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	458 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	459 NAME="AEN390"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	460 >3.6.3. Conditional Assembly</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	461 ></H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	462 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	463 >Portions of the source code can be excluded or included based on conditions
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	464 known at assembly time. Conditionals can be nested arbitrarily deeply. The
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	465 directives associated with conditional assembly are described in this section.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	466 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	467 >All conditionals must be fully bracketed. That is, every conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	468 statement must eventually be followed by an ENDC at the same level of nesting.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	469 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	470 >Conditional expressions are only evaluated on the first assembly pass.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	471 It is not possible to game the assembly process by having a conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	472 change its value between assembly passes. Due to the underlying architecture
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	473 of LWASM, there is no possible utility to IFP1 and IFP2, nor can they, as of LWASM 3.0, actually
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	474 be implemented meaningfully. Thus there is not and never will
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	475 be any equivalent of IFP1 or IFP2 as provided by other assemblers. Use of those opcodes
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	476 will throw a warning and be ignored.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	477 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	478 >It is important to note that if a conditional does not resolve to a constant
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	479 during the first parsing pass, an error will be thrown. This is unavoidable because the assembler
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	480 must make a decision about which source to include and which source to exclude at this stage.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	481 Thus, expressions that work normally elsewhere will not work for conditions.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	482 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	483 ></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	484 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	485 CLASS="VARIABLELIST"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	486 ><DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	487 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	488 >IFEQ <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	489 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	490 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	491 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	492 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	493 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	494 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	495 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	496 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	497 > evaluates to zero, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	498 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	499 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	500 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	501 >IFNE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	502 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	503 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	504 >, IF <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	505 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	506 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	507 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	508 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	509 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	510 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	511 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	512 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	513 > evaluates to a non-zero value, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	514 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	515 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	516 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	517 >IFGT <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	518 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	519 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	520 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	521 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	522 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	523 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	524 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	525 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	526 > evaluates to a value greater than zero, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	527 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	528 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	529 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	530 >IFGE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	531 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	532 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	533 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	534 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	535 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	536 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	537 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	538 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	539 > evaluates to a value greater than or equal to zero, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	540 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	541 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	542 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	543 >IFLT <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	544 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	545 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	546 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	547 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	548 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	549 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	550 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	551 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	552 > evaluates to a value less than zero, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	553 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	554 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	555 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	556 >IFLE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	557 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	558 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	559 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	560 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	561 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	562 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	563 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	564 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	565 > evaluates to a value less than or equal to zero , the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	566 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	567 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	568 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	569 >IFDEF <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	570 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	571 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	572 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	573 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	574 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	575 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	576 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	577 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	578 > is defined at this point in the assembly
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	579 process, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	580 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	581 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	582 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	583 >IFNDEF <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	584 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	585 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	586 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	587 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	588 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	589 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	590 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	591 >sym</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	592 > is not defined at this point in the assembly
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	593 process, the conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	594 will be considered true.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	595 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	596 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	597 >ELSE</DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	598 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	599 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	600 >If the preceding conditional at the same level of nesting was false, the
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	601 statements following will be assembled. If the preceding conditional at
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	602 the same level was true, the statements following will not be assembled.
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	603 Note that the preceding conditional might have been another ELSE statement
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	604 although this behaviour is not guaranteed to be supported in future versions
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	605 of LWASM.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	606 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	607 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	608 >ENDC</DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	609 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	610 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	611 >This directive marks the end of a conditional construct. Every conditional
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	612 construct must end with an ENDC directive.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	613 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	614 ></DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	615 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	616 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	617 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	618 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	619 ><H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	620 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	621 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	622 NAME="AEN455"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	623 >3.6.4. OS9 Target Directives</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	624 ></H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	625 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	626 >This section includes directives that apply solely to the OS9
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	627 target.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	628 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	629 ></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	630 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	631 CLASS="VARIABLELIST"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	632 ><DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	633 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	634 >OS9 <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	635 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	636 >syscall</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	637 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	638 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	639 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	640 > This directive generates a call to the specified system call. <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	641 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	642 >syscall</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	643 > may be an arbitrary expression. </P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	644 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	645 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	646 >MOD <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	647 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	648 >size</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	649 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	650 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	651 >name</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	652 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	653 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	654 >type</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	655 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	656 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	657 >flags</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	658 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	659 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	660 >execoff</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	661 >,<CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	662 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	663 >datasize</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	664 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	665 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	666 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	667 > This tells LWASM that the beginning of the actual module is here. It will
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	668 generate a module header based on the parameters specified. It will also
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	669 begin calcuating the module CRC. </P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	670 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	671 > The precise meaning of the various parameters is beyond the scope of this
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	672 document since it is not a tutorial on OS9 module programming. </P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	673 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	674 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	675 >EMOD</DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	676 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	677 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	678 > This marks the end of a module and causes LWASM to emit the calculated CRC
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	679 for the module. </P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	680 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	681 ></DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	682 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	683 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	684 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	685 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	686 ><H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	687 CLASS="SECTION"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	688 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	689 NAME="AEN480"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	690 >3.6.5. Miscelaneous Directives</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	691 ></H2
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	692 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	693 >This section includes directives that do not fit into the other
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	694 categories.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	695 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	696 ></P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	697 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	698 CLASS="VARIABLELIST"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	699 ><DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	700 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	701 >INCLUDE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	702 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	703 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	704 >, USE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	705 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	706 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	707 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	708 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	709 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	710 > Include the contents of <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	711 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	712 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	713 > at
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	714 this point in the assembly as though it were a part of the file currently
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	715 being processed. Note that if whitespace appears in the name of the file,
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	716 you must enclose <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	717 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	718 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	719 > in quotes.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	720 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	721 >Note that the USE variation is provided only for compatibility with other
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	722 assemblers. It is recommended to use the INCLUDE variation.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	723 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	724 >If <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	725 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	726 >filename</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	727 > begins with a "/", it is
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	728 interpreted as an absolute path. If it does not, the search path will be used
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	729 to find the file. First, the directory containing the file that contains this
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	730 directive. (Includes within an included file are relative to the included file,
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	731 not the file that included it.) If the file is not found there, the include path
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	732 is searched. If it is still not found, an error will be thrown. Note that the
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	733 current directory as understood by your shell or operating system is not searched.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	734 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	735 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	736 >END <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	737 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	738 >[expr]</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	739 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	740 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	741 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	742 >This directive causes the assembler to stop assembling immediately as though
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	743 it ran out of input. For the DECB target only, <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	744 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	745 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	746 >
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	747 can be used to set the execution address of the resulting binary. For all
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	748 other targets, specifying <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	749 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	750 >expr</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	751 > will cause an error.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	752 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	753 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	754 >ERROR <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	755 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	756 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	757 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	758 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	759 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	760 >Causes a custom error message to be printed at this line. This will cause
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	761 assembly to fail. This directive is most useful inside conditional constructs
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	762 to cause assembly to fail if some condition that is known bad happens. Everything
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	763 from the directive to the end of the line is considered the error message.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	764 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	765 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	766 >WARNING <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	767 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	768 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	769 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	770 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	771 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	772 >Causes a custom warning message to be printed at this line. This will not cause
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	773 assembly to fail. This directive is most useful inside conditional constructs
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	774 or include files to alert the programmer to a deprecated feature being used
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	775 or some other condition that may cause trouble later, but which may, in fact,
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	776 not cause any trouble.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	777 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	778 ><DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	779 >.MODULE <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	780 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	781 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	782 ></DT
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	783 ><DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	784 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	785 >This directive is ignored for most output targets. If the output target
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	786 supports encoding a module name into it, <CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	787 CLASS="PARAMETER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	788 >string</CODE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	789 >
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	790 will be used as the module name.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	791 ><P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	792 >As of version 3.0, no supported output targets support this directive.</P
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	793 ></DD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	794 ></DL
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	795 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	796 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	797 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	798 ><DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	799 CLASS="NAVFOOTER"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	800 ><HR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	801 ALIGN="LEFT"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	802 WIDTH="100%"><TABLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	803 SUMMARY="Footer navigation table"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	804 WIDTH="100%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	805 BORDER="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	806 CELLPADDING="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	807 CELLSPACING="0"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	808 ><TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	809 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	810 WIDTH="33%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	811 ALIGN="left"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	812 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	813 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	814 HREF="x221.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	815 ACCESSKEY="P"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	816 >Prev</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	817 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	818 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	819 WIDTH="34%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	820 ALIGN="center"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	821 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	822 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	823 HREF="index.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	824 ACCESSKEY="H"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	825 >Home</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	826 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	827 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	828 WIDTH="33%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	829 ALIGN="right"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	830 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	831 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	832 HREF="x520.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	833 ACCESSKEY="N"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	834 >Next</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	835 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	836 ></TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	837 ><TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	838 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	839 WIDTH="33%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	840 ALIGN="left"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	841 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	842 >Numbers and Expressions</TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	843 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	844 WIDTH="34%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	845 ALIGN="center"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	846 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	847 ><A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	848 HREF="c62.html"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	849 ACCESSKEY="U"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	850 >Up</A
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	851 ></TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	852 ><TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	853 WIDTH="33%"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	854 ALIGN="right"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	855 VALIGN="top"
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	856 >Macros</TD
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	857 ></TR
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	858 ></TABLE
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	859 ></DIV
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	860 ></BODY
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	861 ></HTML
507f442dc71e Add support for 6800 compatibility instructions. William Astle <lost@l-w.ca> parents: diff changeset	862 >

Mercurial > hg > index.cgi

annotate docs/manual/x229.html @ 364:44270b66df3c