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