LWTools: docs/manual/x200.html annotate

annotate docs/manual/x200.html @ 304:d85d173ba120 ccdev

Checkpoint lwcc development - preprocessor is runnable but nonfunctional The preprocessor is currently runnable but doesn't actually do anything useful. This is just a checkpoint.

author	William Astle <lost@l-w.ca>
date	Tue, 17 Sep 2013 19:33:41 -0600
parents	155799f6cfa5
children

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

Mercurial > hg > index.cgi

annotate docs/manual/x200.html @ 304:d85d173ba120 ccdev