LWTools: docs/manual/x220.html annotate

annotate docs/manual/x220.html @ 324:b30091890d62

Add documentation of the new hex output formats. Thanks to text contributed by Tom LeMense, the manual now includes documentation of the hex formats he contributed. This also includes some updated text on the ORG directive. Only minor editorial changes vary the text from Tom's original.

author	William Astle <lost@l-w.ca>
date	Tue, 04 Mar 2014 23:10:13 -0700
parents
children

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

Mercurial > hg > index.cgi

annotate docs/manual/x220.html @ 324:b30091890d62