Mercurial > hg > index.cgi

annotate docs/manual/x599.html @ 261:f45b2a68c3da

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Make case insensitive symbols error out on duplication Make case insensitive symbols raise multiply defined symbol errors in the following circumstances: * if the original symbol was defined under symbolnocase * if the current symbol is being defined under symbolnocse
author William Astle <lost@l-w.ca>
date Mon, 04 Feb 2013 20:51:55 -0700
parents 155799f6cfa5
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
254
155799f6cfa5 Add documentation for the FILL pseudo operation
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">
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
2 <HTML
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
3 ><HEAD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
4 ><TITLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
5 >Assembler Modes and Pragmas</TITLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
6 ><META
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
7 NAME="GENERATOR"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
9 REL="HOME"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
10 TITLE="LW Tool Chain"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
11 HREF="index.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
12 REL="UP"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
13 TITLE="LWASM"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
14 HREF="c45.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
15 REL="PREVIOUS"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
16 TITLE="Object Files and Sections"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
17 HREF="x535.html"><LINK
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
18 REL="NEXT"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
19 TITLE="LWLINK"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
20 HREF="c693.html"></HEAD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
21 ><BODY
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
22 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
23 BGCOLOR="#FFFFFF"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
24 TEXT="#000000"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
25 LINK="#0000FF"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
26 VLINK="#840084"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
27 ALINK="#0000FF"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
28 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
29 CLASS="NAVHEADER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
30 ><TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
31 SUMMARY="Header navigation table"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
32 WIDTH="100%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
33 BORDER="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
34 CELLPADDING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
35 CELLSPACING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
36 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
37 ><TH
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
38 COLSPAN="3"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
39 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
40 >LW Tool Chain</TH
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
41 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
42 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
43 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
44 WIDTH="10%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
45 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
46 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
47 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
48 HREF="x535.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
49 ACCESSKEY="P"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
50 >Prev</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
51 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
52 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
53 WIDTH="80%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
54 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
55 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
56 >Chapter 3. LWASM</TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
57 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
58 WIDTH="10%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
59 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
60 VALIGN="bottom"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
61 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
62 HREF="c693.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
63 ACCESSKEY="N"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
64 >Next</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
65 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
66 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
67 ></TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
68 ><HR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
69 ALIGN="LEFT"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
70 WIDTH="100%"></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
71 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
72 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
73 ><H1
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
74 CLASS="SECTION"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
75 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
76 NAME="AEN599"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
77 >3.10. Assembler Modes and Pragmas</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
78 ></H1
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
79 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
80 >There are a number of options that affect the way assembly is performed.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
81 Some of these options can only be specified on the command line because
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
82 they determine something absolute about the assembly process. These include
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
83 such things as the output target. Other things may be switchable during
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
84 the assembly process. These are known as pragmas and are, by definition,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
85 not portable between assemblers.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
86 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
87 >LWASM supports a number of pragmas that affect code generation or
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
88 otherwise affect the behaviour of the assembler. These may be specified by
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
89 way of a command line option or by assembler directives. The directives
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
90 are as follows.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
91 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
92 ></P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
93 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
94 CLASS="VARIABLELIST"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
95 ><DL
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
96 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
97 >PRAGMA <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
98 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
99 >pragma[,...]</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
100 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
101 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
102 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
103 >Specifies that the assembler should bring into force all <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
104 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
105 >pragma</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
106 >s
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
107 specified. Any unrecognized pragma will cause an assembly error. The new
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
108 pragmas will take effect immediately. This directive should be used when
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
109 the program will assemble incorrectly if the pragma is ignored or not supported.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
110 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
111 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
112 >*PRAGMA <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
113 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
114 >pragma[,...]</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
115 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
116 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
117 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
118 >This is identical to the PRAGMA directive except no error will occur with
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
119 unrecognized or unsupported pragmas. This directive, by virtue of starting
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
120 with a comment character, will also be ignored by assemblers that do not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
121 support this directive. Use this variation if the pragma is not required
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
122 for correct functioning of the code.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
123 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
124 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
125 >*PRAGMAPUSH <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
126 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
127 >pragma[,...]</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
128 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
129 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
130 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
131 >This directive saves the current state of the specified pragma(s) for later retrieval. See discussion below for more information.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
132 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
133 >This directive will not throw any errors for any reason.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
134 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
135 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
136 >*PRAGMAPOP <CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
137 CLASS="PARAMETER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
138 >pragma[,...]</CODE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
139 ></DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
140 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
141 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
142 >This directive restores the previously saved state of the specified pragma(s). See discussion below for more information.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
143 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
144 >This directive will not throw any errors for any reason.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
145 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
146 ></DL
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
147 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
148 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
149 >Each pragma supported has a positive version and a negative version.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
150 The positive version enables the pragma while the negative version disables
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
151 it. The negatitve version is simply the positive version with "no" prefixed
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
152 to it. For instance, "pragma" vs. "nopragma". When only one version is
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
153 listed below, its opposite can be obtained by prepending "no" if it is not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
154 present or removing "no" from the beginning if it is present.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
155 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
156 >Pragmas are not case sensitive.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
157 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
158 ></P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
159 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
160 CLASS="VARIABLELIST"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
161 ><DL
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
162 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
163 >index0tonone</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
164 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
165 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
166 >When in force, this pragma enables an optimization affecting indexed addressing
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
167 modes. When the offset expression in an indexed mode evaluates to zero but is
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
168 not explicity written as 0, this will replace the operand with the equivalent
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
169 no offset mode, thus creating slightly faster code. Because of the advantages
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
170 of this optimization, it is enabled by default.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
171 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
172 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
173 >cescapes</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
174 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
175 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
176 >This pragma will cause strings in the FCC, FCS, and FCN pseudo operations to
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
177 have C-style escape sequences interpreted. The one departure from the official
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
178 spec is that unrecognized escape sequences will return either the character
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
179 immediately following the backslash or some undefined value. Do not rely
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
180 on the behaviour of undefined escape sequences.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
181 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
182 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
183 >importundefexport</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
184 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
185 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
186 >This pragma is only valid for targets that support external references. When
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
187 in force, it will cause the EXPORT directive to act as IMPORT if the symbol
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
188 to be exported is not defined. This is provided for compatibility with the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
189 output of gcc6809 and should not be used in hand written code. Because of
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
190 the confusion this pragma can cause, it is disabled by default.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
191 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
192 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
193 >undefextern</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
194 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
195 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
196 >This pragma is only valid for targets that support external references. When in
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
197 force, if the assembler sees an undefined symbol on the second pass, it will
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
198 automatically define it as an external symbol. This automatic definition will
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
199 apply for the remainder of the assembly process, even if the pragma is
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
200 subsequently turned off. Because this behaviour would be potentially surprising,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
201 this pragma defaults to off.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
202 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
203 >The primary use for this pragma is for projects that share a large number of
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
204 symbols between source files. In such cases, it is impractical to enumerate
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
205 all the external references in every source file. This allows the assembler
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
206 and linker to do the heavy lifting while not preventing a particular source
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
207 module from defining a local symbol of the same name as an external symbol
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
208 if it does not need the external symbol. (This pragma will not cause an
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
209 automatic external definition if there is already a locally defined symbol.)</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
210 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
211 >This pragma will often be specified on the command line for large projects.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
212 However, depending on the specific dynamics of the project, it may be sufficient
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
213 for one or two files to use this pragma internally.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
214 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
215 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
216 >export</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
217 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
218 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
219 >This pragma causes all symbols to be added to the export list
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
220 automatically. This is useful when a large number of symbols need to be
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
221 exported but you do not wish to include an EXPORT directive for all of them.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
222 This is often useful on the command line but might be useful even inline
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
223 with the PRAGMA directive if a large number of symbols in a row are to be
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
224 exported.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
225 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
226 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
227 >dollarlocal</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
228 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
229 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
230 >When set, a "$" in a symbol makes it local. When not set, "$" does not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
231 cause a symbol to be local. It is set by default except when using the OS9
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
232 target.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
233 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
234 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
235 >dollarnotlocal</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
236 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
237 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
238 > This is the same as the "dollarlocal" pragma except its sense is
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
239 reversed. That is, "dollarlocal" and "nodollarnotlocal" are equivalent and
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
240 "nodollarlocal" and "dollarnotlocal" are equivalent. </P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
241 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
242 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
243 >pcaspcr</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
244 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
245 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
246 > Normally, LWASM makes a distinction between PC and PCR in program
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
247 counter relative addressing. In particular, the use of PC means an absolute
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
248 offset from PC while PCR causes the assembler to calculate the offset to the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
249 specified operand and use that as the offset from PC. By setting this
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
250 pragma, you can have PC treated the same as PCR. </P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
251 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
252 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
253 >shadow</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
254 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
255 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
256 >When this pragma is in effect, it becomes possible to define a macro
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
257 that matches an internal operation code. Thus, it makes it possible to
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
258 redefine either CPU instructions or pseudo operations. Because this feature
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
259 is of dubious utility, it is disabled by default.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
260 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
261 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
262 >nolist</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
263 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
264 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
265 >Lines where this pragma is in effect will not appear in the assembly
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
266 listing. Also, any symbols defined under this pragma will not show up in
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
267 the symbol list. This is most useful in include files to avoid spamming the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
268 assembly listing with dozens, hundreds, or thousands of irrelevant
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
269 symbols.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
270 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
271 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
272 >autobranchlength</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
273 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
274 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
275 >One of the perennial annoyances for 6809 programmers is that the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
276 mneumonics for the short and long branch instructions are different (bxx vs.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
277 lbxx), which is at odds with the rest of the instruction set. This pragma
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
278 is a solution to those annoying byte overflow errors that short branch
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
279 instructions tend to aquire.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
280 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
281 >When this pragma is in effect, which is not the default, whenever any
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
282 relative branch instruction is used, its size will be automatically
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
283 determined based on the actual distance to the destination. In other words,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
284 one can write code with long or short branches everywhere and the assembler
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
285 will choose a size for the branch.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
286 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
287 >Also, while this pragma is in effect, the &#62; and &#60; symbols can be used
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
288 to force the branch size, analogous to their use for other instructions with
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
289 &#60; forcing 8 bit offsets and &#62; forcing 16 bit offets.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
290 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
291 >Because this pragma leads to source that is incompatible with other
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
292 assemblers, it is strongly recommended that it be invoked using the PRAGMA
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
293 directive within the source code rather than on the command line or via the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
294 *PRAGMA directive. This way, an error will be raised if someone tries to
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
295 assemble the code under a different assembler.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
296 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
297 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
298 >nosymbolcase, symbolnocase</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
299 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
300 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
301 >Any symbol defined while this pragma is in force will be treated as
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
302 case insensitive, regardless whether the pragma is in force when the symbol
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
303 is referenced.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
304 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
305 >It is important to note that this pragma will not work as expected in
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
306 all cases when using the object file assembly target. It is intended for
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
307 use only when the assembler will be producing the final binary.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
308 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
309 ><DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
310 >condundefzero</DT
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
311 ><DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
312 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
313 >This pragma will cause the assembler to change the way it handles
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
314 symbols in conditional expressions. Ordinarily, any symbol that is not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
315 defined prior to the conditional will throw an undefined symbol error. With
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
316 this pragma in effect, symbols that are not yet defined at the point the
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
317 conditional is encountered will be treated as zero.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
318 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
319 >This is not the default because it encourages poor code design. One
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
320 should use the "IFDEF" or "IFNDEF" conditionals to test for the presence of
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
321 a symbol.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
322 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
323 >It is important to note that if a symbol is defined but it does not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
324 yet evaluate to a constant value at the point where the conditional appears,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
325 the assembler will still complain about a non constant condition.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
326 ></DD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
327 ></DL
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
328 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
329 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
330 >As a convenience, each input file has a pragma state stack. This
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
331 allows, through the use of *PRAGMAPUSH and *PRAGMAPOP, a file to change a
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
332 pragma state and then restore it to the precise state it had previously.
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
333 If, at the end of an input file, all pragma states have not been popped,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
334 they will be removed from the stack. Thus, it is critical to employ
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
335 *PRAGMAPOP correctly. Because each input file has its own pragma stack,
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
336 using *PRAGMAPUSH in one file and *PRAGMAPOP in another file will not
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
337 work.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
338 ><P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
339 >Pragma stacks are more useful in include files, in particular in
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
340 conjunction with the nolist pragma. One can push the state of the nolist
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
341 pragma, engage the nolist pragma, and then pop the state of the nolist
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
342 pragma at the end of the include file. This will cause the entire include
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
343 file to operate under the nolist pragma. However, if the file is included
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
344 while nolist is already engaged, it will not undo that state.</P
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
345 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
346 ><DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
347 CLASS="NAVFOOTER"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
348 ><HR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
349 ALIGN="LEFT"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
350 WIDTH="100%"><TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
351 SUMMARY="Footer navigation table"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
352 WIDTH="100%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
353 BORDER="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
354 CELLPADDING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
355 CELLSPACING="0"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
356 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
357 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
358 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
359 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
360 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
361 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
362 HREF="x535.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
363 ACCESSKEY="P"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
364 >Prev</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
365 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
366 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
367 WIDTH="34%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
368 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
369 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
370 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
371 HREF="index.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
372 ACCESSKEY="H"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
373 >Home</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
374 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
375 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
376 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
377 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
378 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
379 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
380 HREF="c693.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
381 ACCESSKEY="N"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
382 >Next</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
383 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
384 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
385 ><TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
386 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
387 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
388 ALIGN="left"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
389 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
390 >Object Files and Sections</TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
391 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
392 WIDTH="34%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
393 ALIGN="center"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
394 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
395 ><A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
396 HREF="c45.html"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
397 ACCESSKEY="U"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
398 >Up</A
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
399 ></TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
400 ><TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
401 WIDTH="33%"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
402 ALIGN="right"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
403 VALIGN="top"
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
404 >LWLINK</TD
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
405 ></TR
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
406 ></TABLE
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
407 ></DIV
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
408 ></BODY
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
409 ></HTML
155799f6cfa5 Add documentation for the FILL pseudo operation
William Astle <lost@l-w.ca>
parents:
diff changeset
410 >