diff docs/manual/manual.html @ 168:1e0a0e6cd918

Documentation updates
author lost@l-w.ca
date Mon, 29 Aug 2011 19:15:50 -0600
parents 83b7b4ce3bbd
children 2cc599f1bebf
line wrap: on
line diff
--- a/docs/manual/manual.html	Mon Aug 29 19:05:18 2011 -0600
+++ b/docs/manual/manual.html	Mon Aug 29 19:15:50 2011 -0600
@@ -169,43 +169,43 @@
 ></DT
 ><DT
 >3.10. <A
-HREF="#AEN583"
+HREF="#AEN584"
 >Assembler Modes and Pragmas</A
 ></DT
 ></DL
 ></DD
 ><DT
 >4. <A
-HREF="#AEN661"
+HREF="#AEN662"
 >LWLINK</A
 ></DT
 ><DD
 ><DL
 ><DT
 >4.1. <A
-HREF="#AEN664"
+HREF="#AEN665"
 >Command Line Options</A
 ></DT
 ><DT
 >4.2. <A
-HREF="#AEN761"
+HREF="#AEN762"
 >Linker Operation</A
 ></DT
 ><DT
 >4.3. <A
-HREF="#AEN775"
+HREF="#AEN776"
 >Linking Scripts</A
 ></DT
 ><DT
 >4.4. <A
-HREF="#AEN809"
+HREF="#AEN810"
 >Format Specific Linking Notes</A
 ></DT
 ><DD
 ><DL
 ><DT
 >4.4.1. <A
-HREF="#AEN812"
+HREF="#AEN813"
 >OS9 Modules</A
 ></DT
 ></DL
@@ -214,14 +214,14 @@
 ></DD
 ><DT
 >5. <A
-HREF="#AEN824"
+HREF="#AEN825"
 >Libraries and LWAR</A
 ></DT
 ><DD
 ><DL
 ><DT
 >5.1. <A
-HREF="#AEN828"
+HREF="#AEN829"
 >Command Line Options</A
 ></DT
 ></DL
@@ -243,12 +243,12 @@
 ></DT
 ><DT
 >6-1. <A
-HREF="#AEN911"
+HREF="#AEN912"
 >Object File Term Types</A
 ></DT
 ><DT
 >6-2. <A
-HREF="#AEN941"
+HREF="#AEN942"
 >Object File Operator Numbers</A
 ></DT
 ></DL
@@ -1828,16 +1828,21 @@
 > may only be specified on the first
 instance of the section.</P
 ><P
->There is a single flag supported in <CODE
+><CODE
 CLASS="PARAMETER"
 >flags</CODE
->. The
-flag <CODE
-CLASS="PARAMETER"
->bss</CODE
-> will cause the section to be treated as a BSS
-section and, thus, no code will be included in the object file nor will any
-bytes be permitted to be output.</P
+> is a comma separated list of flags. If a
+flag is "bss", the section will be treated as a BSS section and no
+statements that generate output are permitted.</P
+><P
+>If the flag is "constant",
+the same restrictions apply as for BSS sections.  Additionally, all symbols
+defined in a constant section define absolute values and will not be
+adjusted by the linker at link time.  Constant sections cannot define
+complex expressions for symbols; the value must be fully defined at assembly
+time.  Additionally, multiple instances of a constant section do not
+coalesce into a single addressing unit; each instance starts again at offset
+0.</P
 ><P
 >If the section name is "bss" or ".bss" in any combination of upper and
 lower case, the section is assumed to be a BSS section. In that case,
@@ -1846,6 +1851,11 @@
 >!bss</CODE
 > can be used to override this assumption.</P
 ><P
+> If the section name is "_constants" or "_constant", in any
+combination of upper and lower case, the section is assumed to be a constant
+section.  This assumption can be overridden with the "!constant"
+flag.</P
+><P
 >If assembly is already happening within a section, the section is implicitly
 ended and the new section started. This is not considered an error although
 it is recommended that all sections be explicitly closed.</P
@@ -1935,7 +1945,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN583"
+NAME="AEN584"
 >3.10. Assembler Modes and Pragmas</A
 ></H2
 ><P
@@ -2168,7 +2178,7 @@
 CLASS="CHAPTER"
 ><HR><H1
 ><A
-NAME="AEN661"
+NAME="AEN662"
 ></A
 >Chapter 4. LWLINK</H1
 ><P
@@ -2179,7 +2189,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN664"
+NAME="AEN665"
 >4.1. Command Line Options</A
 ></H2
 ><P
@@ -2376,7 +2386,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN761"
+NAME="AEN762"
 >4.2. Linker Operation</A
 ></H2
 ><P
@@ -2432,7 +2442,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN775"
+NAME="AEN776"
 >4.3. Linking Scripts</A
 ></H2
 ><P
@@ -2540,7 +2550,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN809"
+NAME="AEN810"
 >4.4. Format Specific Linking Notes</A
 ></H2
 ><P
@@ -2553,7 +2563,7 @@
 ><HR><H3
 CLASS="SECTION"
 ><A
-NAME="AEN812"
+NAME="AEN813"
 >4.4.1. OS9 Modules</A
 ></H3
 ><P
@@ -2629,7 +2639,7 @@
 CLASS="CHAPTER"
 ><HR><H1
 ><A
-NAME="AEN824"
+NAME="AEN825"
 ></A
 >Chapter 5. Libraries and LWAR</H1
 ><P
@@ -2648,7 +2658,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN828"
+NAME="AEN829"
 >5.1. Command Line Options</A
 ></H2
 ><P
@@ -2849,7 +2859,7 @@
 ><DIV
 CLASS="TABLE"
 ><A
-NAME="AEN911"
+NAME="AEN912"
 ></A
 ><P
 ><B
@@ -2921,7 +2931,7 @@
 ><DIV
 CLASS="TABLE"
 ><A
-NAME="AEN941"
+NAME="AEN942"
 ></A
 ><P
 ><B