Mercurial > hg > index.cgi

comparison docs/manual/x520.html @ 168:1e0a0e6cd918

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Documentation updates
author lost@l-w.ca
date Mon, 29 Aug 2011 19:15:50 -0600
parents 83b7b4ce3bbd
children
comparison
equal deleted inserted replaced
167:872fa82680e1 168:1e0a0e6cd918
15 REL="PREVIOUS" 15 REL="PREVIOUS"
16 TITLE="Structures" 16 TITLE="Structures"
17 HREF="x499.html"><LINK 17 HREF="x499.html"><LINK
18 REL="NEXT" 18 REL="NEXT"
19 TITLE="Assembler Modes and Pragmas" 19 TITLE="Assembler Modes and Pragmas"
20 HREF="x583.html"></HEAD 20 HREF="x584.html"></HEAD
21 ><BODY 21 ><BODY
22 CLASS="SECTION" 22 CLASS="SECTION"
23 BGCOLOR="#FFFFFF" 23 BGCOLOR="#FFFFFF"
24 TEXT="#000000" 24 TEXT="#000000"
25 LINK="#0000FF" 25 LINK="#0000FF"
57 ><TD 57 ><TD
58 WIDTH="10%" 58 WIDTH="10%"
59 ALIGN="right" 59 ALIGN="right"
60 VALIGN="bottom" 60 VALIGN="bottom"
61 ><A 61 ><A
62 HREF="x583.html" 62 HREF="x584.html"
63 ACCESSKEY="N" 63 ACCESSKEY="N"
64 >Next</A 64 >Next</A
65 ></TD 65 ></TD
66 ></TR 66 ></TR
67 ></TABLE 67 ></TABLE
171 CLASS="PARAMETER" 171 CLASS="PARAMETER"
172 >flags</CODE 172 >flags</CODE
173 > may only be specified on the first 173 > may only be specified on the first
174 instance of the section.</P 174 instance of the section.</P
175 ><P 175 ><P
176 >There is a single flag supported in <CODE 176 ><CODE
177 CLASS="PARAMETER" 177 CLASS="PARAMETER"
178 >flags</CODE 178 >flags</CODE
179 >. The 179 > is a comma separated list of flags. If a
180 flag <CODE 180 flag is "bss", the section will be treated as a BSS section and no
181 CLASS="PARAMETER" 181 statements that generate output are permitted.</P
182 >bss</CODE 182 ><P
183 > will cause the section to be treated as a BSS 183 >If the flag is "constant",
184 section and, thus, no code will be included in the object file nor will any 184 the same restrictions apply as for BSS sections. Additionally, all symbols
185 bytes be permitted to be output.</P 185 defined in a constant section define absolute values and will not be
186 adjusted by the linker at link time. Constant sections cannot define
187 complex expressions for symbols; the value must be fully defined at assembly
188 time. Additionally, multiple instances of a constant section do not
189 coalesce into a single addressing unit; each instance starts again at offset
190 0.</P
186 ><P 191 ><P
187 >If the section name is "bss" or ".bss" in any combination of upper and 192 >If the section name is "bss" or ".bss" in any combination of upper and
188 lower case, the section is assumed to be a BSS section. In that case, 193 lower case, the section is assumed to be a BSS section. In that case,
189 the flag <CODE 194 the flag <CODE
190 CLASS="PARAMETER" 195 CLASS="PARAMETER"
191 >!bss</CODE 196 >!bss</CODE
192 > can be used to override this assumption.</P 197 > can be used to override this assumption.</P
198 ><P
199 > If the section name is "_constants" or "_constant", in any
200 combination of upper and lower case, the section is assumed to be a constant
201 section. This assumption can be overridden with the "!constant"
202 flag.</P
193 ><P 203 ><P
194 >If assembly is already happening within a section, the section is implicitly 204 >If assembly is already happening within a section, the section is implicitly
195 ended and the new section started. This is not considered an error although 205 ended and the new section started. This is not considered an error although
196 it is recommended that all sections be explicitly closed.</P 206 it is recommended that all sections be explicitly closed.</P
197 ></DD 207 ></DD
307 ><TD 317 ><TD
308 WIDTH="33%" 318 WIDTH="33%"
309 ALIGN="right" 319 ALIGN="right"
310 VALIGN="top" 320 VALIGN="top"
311 ><A 321 ><A
312 HREF="x583.html" 322 HREF="x584.html"
313 ACCESSKEY="N" 323 ACCESSKEY="N"
314 >Next</A 324 >Next</A
315 ></TD 325 ></TD
316 ></TR 326 ></TR
317 ><TR 327 ><TR