Mercurial > hg > index.cgi

diff docs/manual/x670.html @ 517:1faf14de9d04

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Update manual to correctly reflect forwardrefmax behaviour Add a note to autobranchlength referencing forwardrefmax and also not that forwardrefmax is enabled by default.
author William Astle <lost@l-w.ca>
date Tue, 13 Apr 2021 15:38:12 -0600
parents 52af0aa54fe5
children 8c6c3363e18e
line wrap: on
line diff
--- a/docs/manual/x670.html	Thu Feb 11 09:25:16 2021 -0700
+++ b/docs/manual/x670.html	Tue Apr 13 15:38:12 2021 -0600
@@ -17,7 +17,7 @@
 HREF="x606.html"><LINK
 REL="NEXT"
 TITLE="Convenience Instructions"
-HREF="x816.html"></HEAD
+HREF="x817.html"></HEAD
 ><BODY
 CLASS="SECTION"
 BGCOLOR="#FFFFFF"
@@ -59,7 +59,7 @@
 ALIGN="right"
 VALIGN="bottom"
 ><A
-HREF="x816.html"
+HREF="x817.html"
 ACCESSKEY="N"
 >Next</A
 ></TD
@@ -198,7 +198,7 @@
 >These pragmas enable convenience instructions extending the 6809 and 6309
 instruction sets respectively. For more information, see 
 <A
-HREF="x816.html"
+HREF="x817.html"
 >Section 3.11</A
 >.</P
 ></DD
@@ -336,6 +336,9 @@
 directive within the source code rather than on the command line or via the
 *PRAGMA directive.  This way, an error will be raised if someone tries to
 assemble the code under a different assembler.</P
+><P
+>Note that if the "forwardrefmax" pragma is ineffect, as is the current
+default, this pragma will not behave as expected.</P
 ></DD
 ><DT
 >nosymbolcase, symbolnocase</DT
@@ -372,14 +375,15 @@
 ><DD
 ><P
 >This pragma will disable forward reference optimization completely.
-Ordinarily, LWASM will attempt to select the shortest possible addressing
-mode for forward references.  However, in many source files, especially
+However, many source files, especially
 those not using the PCR relative addressing modes, this optimization is
 pointless since the assembler will almost certainly settle on a 16 bit
 offset or address.  If all variables in the direct page are defined before
 the main body of the code, the benefit of forward reference optimization
 almost certainly vanishes completely.  However, the cost of doing that
-optimization remains and can result in a very long assembly time.</P
+optimization remains and can result in a very long assembly time. Because
+of this, "forwardrefmax" has been the default setting since version 4.14 of
+LWTOOLS. To turn it off, use "noforwardrefmax".</P
 ><P
 >Enabling this pragma will cause all forward references to use the
 maximum offset or address size, much the same has EDTASM and other pure
@@ -542,7 +546,7 @@
 ALIGN="right"
 VALIGN="top"
 ><A
-HREF="x816.html"
+HREF="x817.html"
 ACCESSKEY="N"
 >Next</A
 ></TD