Mercurial > hg > index.cgi

comparison docs/manual/x187.html @ 231:2cc599f1bebf

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Added --define to lwasm documentation. Added documentation of the -D/--define command line option for lwasm. It has been present for a long time but has somehow escaped documentation.
author William Astle <lost@l-w.ca>
date Sun, 15 Jul 2012 23:12:09 -0600
parents
children
comparison
equal deleted inserted replaced
230:e09985968e64 231:2cc599f1bebf
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
2 <HTML
3 ><HEAD
4 ><TITLE
5 >Symbols</TITLE
6 ><META
7 NAME="GENERATOR"
8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
9 REL="HOME"
10 TITLE="LW Tool Chain"
11 HREF="index.html"><LINK
12 REL="UP"
13 TITLE="LWASM"
14 HREF="c45.html"><LINK
15 REL="PREVIOUS"
16 TITLE="Source Format"
17 HREF="x177.html"><LINK
18 REL="NEXT"
19 TITLE="Numbers and Expressions"
20 HREF="x192.html"></HEAD
21 ><BODY
22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF"
24 TEXT="#000000"
25 LINK="#0000FF"
26 VLINK="#840084"
27 ALINK="#0000FF"
28 ><DIV
29 CLASS="NAVHEADER"
30 ><TABLE
31 SUMMARY="Header navigation table"
32 WIDTH="100%"
33 BORDER="0"
34 CELLPADDING="0"
35 CELLSPACING="0"
36 ><TR
37 ><TH
38 COLSPAN="3"
39 ALIGN="center"
40 >LW Tool Chain</TH
41 ></TR
42 ><TR
43 ><TD
44 WIDTH="10%"
45 ALIGN="left"
46 VALIGN="bottom"
47 ><A
48 HREF="x177.html"
49 ACCESSKEY="P"
50 >Prev</A
51 ></TD
52 ><TD
53 WIDTH="80%"
54 ALIGN="center"
55 VALIGN="bottom"
56 >Chapter 3. LWASM</TD
57 ><TD
58 WIDTH="10%"
59 ALIGN="right"
60 VALIGN="bottom"
61 ><A
62 HREF="x192.html"
63 ACCESSKEY="N"
64 >Next</A
65 ></TD
66 ></TR
67 ></TABLE
68 ><HR
69 ALIGN="LEFT"
70 WIDTH="100%"></DIV
71 ><DIV
72 CLASS="SECTION"
73 ><H1
74 CLASS="SECTION"
75 ><A
76 NAME="AEN187"
77 >3.4. Symbols</A
78 ></H1
79 ><P
80 >Symbols have no length restriction. They may contain letters, numbers, dots,
81 dollar signs, and underscores. They must start with a letter, dot, or
82 underscore.</P
83 ><P
84 >LWASM also supports the concept of a local symbol. A local symbol is one
85 which contains either a "?" or a "@", which can appear anywhere in the symbol.
86 The scope of a local symbol is determined by a number of factors. First,
87 each included file gets its own local symbol scope. A blank line will also
88 be considered a local scope barrier. Macros each have their own local symbol
89 scope as well (which has a side effect that you cannot use a local symbol
90 as an argument to a macro). There are other factors as well. In general,
91 a local symbol is restricted to the block of code it is defined within.</P
92 ><P
93 >By default, unless assembling to the os9 target, a "$" in the symbol will
94 also make it local. This can be controlled by the "dollarlocal" and
95 "nodollarlocal" pragmas. In the absence of a pragma to the contrary, for
96 the os9 target, a "$" in the symbol will not make it considered local while
97 for all other targets it will.</P
98 ></DIV
99 ><DIV
100 CLASS="NAVFOOTER"
101 ><HR
102 ALIGN="LEFT"
103 WIDTH="100%"><TABLE
104 SUMMARY="Footer navigation table"
105 WIDTH="100%"
106 BORDER="0"
107 CELLPADDING="0"
108 CELLSPACING="0"
109 ><TR
110 ><TD
111 WIDTH="33%"
112 ALIGN="left"
113 VALIGN="top"
114 ><A
115 HREF="x177.html"
116 ACCESSKEY="P"
117 >Prev</A
118 ></TD
119 ><TD
120 WIDTH="34%"
121 ALIGN="center"
122 VALIGN="top"
123 ><A
124 HREF="index.html"
125 ACCESSKEY="H"
126 >Home</A
127 ></TD
128 ><TD
129 WIDTH="33%"
130 ALIGN="right"
131 VALIGN="top"
132 ><A
133 HREF="x192.html"
134 ACCESSKEY="N"
135 >Next</A
136 ></TD
137 ></TR
138 ><TR
139 ><TD
140 WIDTH="33%"
141 ALIGN="left"
142 VALIGN="top"
143 >Source Format</TD
144 ><TD
145 WIDTH="34%"
146 ALIGN="center"
147 VALIGN="top"
148 ><A
149 HREF="c45.html"
150 ACCESSKEY="U"
151 >Up</A
152 ></TD
153 ><TD
154 WIDTH="33%"
155 ALIGN="right"
156 VALIGN="top"
157 >Numbers and Expressions</TD
158 ></TR
159 ></TABLE
160 ></DIV
161 ></BODY
162 ></HTML
163 >