annotate doc/manual/x144.html @ 153:ffef3ea07399 2.1 2.1

Preparing for release
author lost
date Fri, 30 Jan 2009 04:32:55 +0000
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
153
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
2 <HTML
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
3 ><HEAD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
4 ><TITLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
5 >Assembler Directives</TITLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
6 ><META
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
7 NAME="GENERATOR"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
9 REL="HOME"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
10 TITLE="LW Tool Chain"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
11 HREF="index.html"><LINK
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
12 REL="UP"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
13 TITLE="LWASM"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
14 HREF="c35.html"><LINK
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
15 REL="PREVIOUS"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
16 TITLE="Numbers and Expressions"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
17 HREF="x137.html"><LINK
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
18 REL="NEXT"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
19 TITLE="Macros"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
20 HREF="x339.html"></HEAD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
21 ><BODY
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
22 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
23 BGCOLOR="#FFFFFF"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
24 TEXT="#000000"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
25 LINK="#0000FF"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
26 VLINK="#840084"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
27 ALINK="#0000FF"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
28 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
29 CLASS="NAVHEADER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
30 ><TABLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
31 SUMMARY="Header navigation table"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
32 WIDTH="100%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
33 BORDER="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
34 CELLPADDING="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
35 CELLSPACING="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
36 ><TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
37 ><TH
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
38 COLSPAN="3"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
39 ALIGN="center"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
40 >LW Tool Chain</TH
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
41 ></TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
42 ><TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
43 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
44 WIDTH="10%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
45 ALIGN="left"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
46 VALIGN="bottom"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
47 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
48 HREF="x137.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
49 ACCESSKEY="P"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
50 >Prev</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
51 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
52 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
53 WIDTH="80%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
54 ALIGN="center"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
55 VALIGN="bottom"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
56 >Chapter 3. LWASM</TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
57 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
58 WIDTH="10%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
59 ALIGN="right"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
60 VALIGN="bottom"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
61 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
62 HREF="x339.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
63 ACCESSKEY="N"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
64 >Next</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
65 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
66 ></TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
67 ></TABLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
68 ><HR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
69 ALIGN="LEFT"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
70 WIDTH="100%"></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
71 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
72 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
73 ><H1
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
74 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
75 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
76 NAME="AEN144"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
77 >3.6. Assembler Directives</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
78 ></H1
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
79 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
80 >Various directives can be used to control the behaviour of the
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
81 assembler or to include non-code/data in the resulting output. Those directives
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
82 that are not described in detail in other sections of this document are
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
83 described below.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
84 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
85 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
86 ><H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
87 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
88 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
89 NAME="AEN147"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
90 >3.6.1. Data Directives</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
91 ></H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
92 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
93 ></P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
94 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
95 CLASS="VARIABLELIST"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
96 ><DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
97 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
98 >FCB <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
99 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
100 >expr[,...]</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
101 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
102 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
103 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
104 >Include one or more constant bytes (separated by commas) in the output.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
105 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
106 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
107 >FDB <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
108 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
109 >expr[,...]</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
110 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
111 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
112 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
113 >Include one or more words (separated by commas) in the output.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
114 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
115 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
116 >FQB <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
117 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
118 >expr[,...]</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
119 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
120 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
121 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
122 >Include one or more double words (separated by commas) in the output.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
123 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
124 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
125 >FCC <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
126 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
127 >string</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
128 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
129 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
130 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
131 >Include a string of text in the output. The first character of the operand
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
132 is the delimiter which must appear as the last character and cannot appear
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
133 within the string. The string is included with no modifications&#62;</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
134 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
135 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
136 >FCN <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
137 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
138 >string</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
139 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
140 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
141 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
142 >Include a NUL terminated string of text in the output. The first character of
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
143 the operand is the delimiter which must appear as the last character and
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
144 cannot appear within the string. A NUL byte is automatically appended to
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
145 the string.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
146 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
147 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
148 >FCS <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
149 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
150 >string</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
151 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
152 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
153 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
154 >Include a string of text in the output with bit 7 of the final byte set. The
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
155 first character of the operand is the delimiter which must appear as the last
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
156 character and cannot appear within the string.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
157 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
158 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
159 >ZMB <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
160 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
161 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
162 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
163 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
164 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
165 >Include a number of NUL bytes in the output. The number must be fully resolvable
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
166 during pass 1 of assembly so no forward or external references are permitted.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
167 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
168 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
169 >ZMD <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
170 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
171 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
172 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
173 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
174 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
175 >Include a number of zero words in the output. The number must be fully
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
176 resolvable during pass 1 of assembly so no forward or external references are
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
177 permitted.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
178 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
179 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
180 >ZMQ <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
181 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
182 >expr<CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
183 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
184 ></CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
185 ></CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
186 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
187 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
188 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
189 >Include a number of zero double-words in the output. The number must be fully
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
190 resolvable during pass 1 of assembly so no forward or external references are
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
191 permitted.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
192 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
193 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
194 >RMB <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
195 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
196 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
197 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
198 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
199 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
200 >Reserve a number of bytes in the output. The number must be fully resolvable
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
201 during pass 1 of assembly so no forward or external references are permitted.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
202 The value of the bytes is undefined.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
203 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
204 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
205 >RMD <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
206 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
207 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
208 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
209 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
210 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
211 >Reserve a number of words in the output. The number must be fully
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
212 resolvable during pass 1 of assembly so no forward or external references are
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
213 permitted. The value of the words is undefined.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
214 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
215 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
216 >RMQ <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
217 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
218 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
219 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
220 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
221 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
222 >Reserve a number of double-words in the output. The number must be fully
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
223 resolvable during pass 1 of assembly so no forward or external references are
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
224 permitted. The value of the double-words is undefined.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
225 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
226 ></DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
227 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
228 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
229 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
230 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
231 ><H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
232 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
233 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
234 NAME="AEN211"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
235 >3.6.2. Address Definition</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
236 ></H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
237 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
238 >The directives in this section all control the addresses of symbols
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
239 or the assembly process itself.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
240 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
241 ></P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
242 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
243 CLASS="VARIABLELIST"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
244 ><DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
245 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
246 >ORG <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
247 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
248 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
249 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
250 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
251 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
252 >Set the assembly address. The address must be fully resolvable on the
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
253 first pass so no external or forward references are permitted. ORG is not
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
254 permitted within sections when outputting to object files. For the DECB
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
255 target, each ORG directive after which output is generated will cause
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
256 a new preamble to be output. ORG is only used to determine the addresses
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
257 of symbols when the raw target is used.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
258 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
259 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
260 ><CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
261 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
262 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
263 > EQU <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
264 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
265 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
266 >, <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
267 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
268 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
269 > = <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
270 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
271 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
272 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
273 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
274 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
275 >Define the value of <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
276 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
277 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
278 > to be <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
279 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
280 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
281 >.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
282 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
283 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
284 ><CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
285 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
286 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
287 > SET <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
288 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
289 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
290 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
291 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
292 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
293 >Define the value of <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
294 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
295 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
296 > to be <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
297 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
298 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
299 >.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
300 Unlike EQU, SET permits symbols to be defined multiple times as long as SET
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
301 is used for all instances. Use of the symbol before the first SET statement
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
302 that sets its value is undefined.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
303 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
304 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
305 >SETDP <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
306 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
307 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
308 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
309 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
310 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
311 >Inform the assembler that it can assume the DP register contains
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
312 <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
313 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
314 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
315 >. This directive is only advice to the assembler
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
316 to determine whether an address is in the direct page and has no effect
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
317 on the contents of the DP register. The value must be fully resolved during
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
318 the first assembly pass because it affects the sizes of subsequent instructions.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
319 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
320 >This directive has no effect in the object file target.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
321 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
322 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
323 >ALIGN <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
324 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
325 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
326 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
327 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
328 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
329 >Force the current assembly address to be a multiple of <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
330 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
331 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
332 >.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
333 A series of NUL bytes is output to force the alignment, if required. The
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
334 alignment value must be fully resolved on the first pass because it affects
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
335 the addresses of subsquent instructions.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
336 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
337 >This directive is not suitable for inclusion in the middle of actual
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
338 code. It is intended to appear where the bytes output will not be executed.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
339 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
340 ></DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
341 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
342 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
343 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
344 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
345 ><H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
346 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
347 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
348 NAME="AEN253"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
349 >3.6.3. Conditional Assembly</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
350 ></H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
351 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
352 >Portions of the source code can be excluded or included based on conditions
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
353 known at assembly time. Conditionals can be nested arbitrarily deeply. The
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
354 directives associated with conditional assembly are described in this section.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
355 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
356 >All conditionals must be fully bracketed. That is, every conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
357 statement must eventually be followed by an ENDC at the same level of nesting.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
358 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
359 >Conditional expressions are only evaluated on the first assembly pass.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
360 It is not possible to game the assembly process by having a conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
361 change its value between assembly passes. Thus there is not and never will
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
362 be any equivalent of IFP1 or IFP2 as provided by other assemblers.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
363 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
364 ></P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
365 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
366 CLASS="VARIABLELIST"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
367 ><DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
368 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
369 >IFEQ <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
370 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
371 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
372 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
373 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
374 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
375 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
376 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
377 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
378 > evaluates to zero, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
379 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
380 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
381 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
382 >IFNE <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
383 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
384 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
385 >, IF <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
386 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
387 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
388 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
389 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
390 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
391 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
392 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
393 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
394 > evaluates to a non-zero value, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
395 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
396 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
397 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
398 >IFGT <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
399 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
400 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
401 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
402 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
403 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
404 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
405 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
406 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
407 > evaluates to a value greater than zero, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
408 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
409 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
410 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
411 >IFGE <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
412 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
413 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
414 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
415 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
416 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
417 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
418 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
419 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
420 > evaluates to a value greater than or equal to zero, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
421 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
422 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
423 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
424 >IFLT <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
425 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
426 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
427 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
428 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
429 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
430 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
431 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
432 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
433 > evaluates to a value less than zero, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
434 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
435 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
436 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
437 >IFLE <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
438 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
439 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
440 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
441 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
442 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
443 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
444 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
445 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
446 > evaluates to a value less than or equal to zero , the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
447 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
448 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
449 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
450 >IFDEF <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
451 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
452 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
453 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
454 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
455 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
456 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
457 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
458 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
459 > is defined at this point in the assembly
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
460 process, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
461 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
462 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
463 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
464 >IFNDEF <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
465 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
466 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
467 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
468 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
469 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
470 >If <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
471 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
472 >sym</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
473 > is not defined at this point in the assembly
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
474 process, the conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
475 will be considered true.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
476 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
477 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
478 >ELSE</DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
479 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
480 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
481 >If the preceding conditional at the same level of nesting was false, the
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
482 statements following will be assembled. If the preceding conditional at
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
483 the same level was true, the statements following will not be assembled.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
484 Note that the preceding conditional might have been another ELSE statement
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
485 although this behaviour is not guaranteed to be supported in future versions
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
486 of LWASM.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
487 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
488 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
489 >ENDC</DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
490 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
491 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
492 >This directive marks the end of a conditional construct. Every conditional
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
493 construct must end with an ENDC directive.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
494 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
495 ></DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
496 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
497 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
498 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
499 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
500 ><H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
501 CLASS="SECTION"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
502 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
503 NAME="AEN317"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
504 >3.6.4. Miscelaneous Directives</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
505 ></H2
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
506 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
507 >This section includes directives that do not fit into the other
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
508 categories.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
509 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
510 ></P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
511 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
512 CLASS="VARIABLELIST"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
513 ><DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
514 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
515 >INCLUDE <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
516 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
517 >filename</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
518 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
519 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
520 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
521 >Include the contents of <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
522 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
523 >filename</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
524 > at this point in
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
525 the assembly as though it were a part of the file currently being processed.
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
526 Note that whitespace cannot appear in the name of the file.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
527 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
528 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
529 >END <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
530 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
531 >[expr]</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
532 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
533 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
534 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
535 >This directive causes the assembler to stop assembling immediately as though
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
536 it ran out of input. For the DECB target only, <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
537 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
538 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
539 >
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
540 can be used to set the execution address of the resulting binary. For all
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
541 other targets, specifying <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
542 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
543 >expr</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
544 > will cause an error.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
545 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
546 ><DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
547 >ERROR <CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
548 CLASS="PARAMETER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
549 >string</CODE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
550 ></DT
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
551 ><DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
552 ><P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
553 >Causes a custom error message to be printed at this line. This will cause
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
554 assembly to fail. This directive is most useful inside conditional constructs
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
555 to cause assembly to fail if some condition that is known bad happens.</P
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
556 ></DD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
557 ></DL
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
558 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
559 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
560 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
561 ><DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
562 CLASS="NAVFOOTER"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
563 ><HR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
564 ALIGN="LEFT"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
565 WIDTH="100%"><TABLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
566 SUMMARY="Footer navigation table"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
567 WIDTH="100%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
568 BORDER="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
569 CELLPADDING="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
570 CELLSPACING="0"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
571 ><TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
572 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
573 WIDTH="33%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
574 ALIGN="left"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
575 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
576 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
577 HREF="x137.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
578 ACCESSKEY="P"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
579 >Prev</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
580 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
581 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
582 WIDTH="34%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
583 ALIGN="center"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
584 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
585 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
586 HREF="index.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
587 ACCESSKEY="H"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
588 >Home</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
589 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
590 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
591 WIDTH="33%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
592 ALIGN="right"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
593 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
594 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
595 HREF="x339.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
596 ACCESSKEY="N"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
597 >Next</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
598 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
599 ></TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
600 ><TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
601 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
602 WIDTH="33%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
603 ALIGN="left"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
604 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
605 >Numbers and Expressions</TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
606 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
607 WIDTH="34%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
608 ALIGN="center"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
609 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
610 ><A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
611 HREF="c35.html"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
612 ACCESSKEY="U"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
613 >Up</A
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
614 ></TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
615 ><TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
616 WIDTH="33%"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
617 ALIGN="right"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
618 VALIGN="top"
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
619 >Macros</TD
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
620 ></TR
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
621 ></TABLE
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
622 ></DIV
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
623 ></BODY
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
624 ></HTML
ffef3ea07399 Preparing for release
lost
parents:
diff changeset
625 >