Mercurial > hg > index.cgi
comparison docs/manual.docbook.sgml @ 168:1e0a0e6cd918
Documentation updates
author | lost@l-w.ca |
---|---|
date | Mon, 29 Aug 2011 19:15:50 -0600 |
parents | a26b045c4e18 |
children | 07e1fac76321 |
comparison
equal
deleted
inserted
replaced
167:872fa82680e1 | 168:1e0a0e6cd918 |
---|---|
1328 may appear multiple times in which case it is as though all the code from | 1328 may appear multiple times in which case it is as though all the code from |
1329 all the instances of that section appeared adjacent within the source file. | 1329 all the instances of that section appeared adjacent within the source file. |
1330 However, <parameter>flags</parameter> may only be specified on the first | 1330 However, <parameter>flags</parameter> may only be specified on the first |
1331 instance of the section. | 1331 instance of the section. |
1332 </para> | 1332 </para> |
1333 <para>There is a single flag supported in <parameter>flags</parameter>. The | 1333 |
1334 flag <parameter>bss</parameter> will cause the section to be treated as a BSS | 1334 <para><parameter>flags</parameter> is a comma separated list of flags. If a |
1335 section and, thus, no code will be included in the object file nor will any | 1335 flag is "bss", the section will be treated as a BSS section and no |
1336 bytes be permitted to be output.</para> | 1336 statements that generate output are permitted.</para> |
1337 | |
1338 <para>If the flag is "constant", | |
1339 the same restrictions apply as for BSS sections. Additionally, all symbols | |
1340 defined in a constant section define absolute values and will not be | |
1341 adjusted by the linker at link time. Constant sections cannot define | |
1342 complex expressions for symbols; the value must be fully defined at assembly | |
1343 time. Additionally, multiple instances of a constant section do not | |
1344 coalesce into a single addressing unit; each instance starts again at offset | |
1345 0.</para> | |
1346 | |
1337 <para> | 1347 <para> |
1338 If the section name is "bss" or ".bss" in any combination of upper and | 1348 If the section name is "bss" or ".bss" in any combination of upper and |
1339 lower case, the section is assumed to be a BSS section. In that case, | 1349 lower case, the section is assumed to be a BSS section. In that case, |
1340 the flag <parameter>!bss</parameter> can be used to override this assumption. | 1350 the flag <parameter>!bss</parameter> can be used to override this assumption. |
1341 </para> | 1351 </para> |
1352 | |
1353 <para> If the section name is "_constants" or "_constant", in any | |
1354 combination of upper and lower case, the section is assumed to be a constant | |
1355 section. This assumption can be overridden with the "!constant" | |
1356 flag.</para> | |
1357 | |
1342 <para> | 1358 <para> |
1343 If assembly is already happening within a section, the section is implicitly | 1359 If assembly is already happening within a section, the section is implicitly |
1344 ended and the new section started. This is not considered an error although | 1360 ended and the new section started. This is not considered an error although |
1345 it is recommended that all sections be explicitly closed. | 1361 it is recommended that all sections be explicitly closed. |
1346 </para> | 1362 </para> |