diff docs/manual/manual.html @ 455:cad5937314cb

Add operandsizewarning pragma Add operandsizewarning pragma that will raise warnings for certain operands if the operand size could be smaller. (Long branch used instead of short branch, for instance.)
author William Astle <lost@l-w.ca>
date Fri, 16 Feb 2018 22:53:46 -0700
parents 566660ef3b4d
children a71206ed966c
line wrap: on
line diff
--- a/docs/manual/manual.html	Fri Feb 16 22:52:44 2018 -0700
+++ b/docs/manual/manual.html	Fri Feb 16 22:53:46 2018 -0700
@@ -200,43 +200,43 @@
 ></DT
 ><DT
 >3.12. <A
-HREF="#AEN800"
+HREF="#AEN805"
 >Cycle Counts</A
 ></DT
 ></DL
 ></DD
 ><DT
 >4. <A
-HREF="#AEN806"
+HREF="#AEN811"
 >LWLINK</A
 ></DT
 ><DD
 ><DL
 ><DT
 >4.1. <A
-HREF="#AEN809"
+HREF="#AEN814"
 >Command Line Options</A
 ></DT
 ><DT
 >4.2. <A
-HREF="#AEN906"
+HREF="#AEN911"
 >Linker Operation</A
 ></DT
 ><DT
 >4.3. <A
-HREF="#AEN920"
+HREF="#AEN925"
 >Linking Scripts</A
 ></DT
 ><DT
 >4.4. <A
-HREF="#AEN986"
+HREF="#AEN991"
 >Format Specific Linking Notes</A
 ></DT
 ><DD
 ><DL
 ><DT
 >4.4.1. <A
-HREF="#AEN989"
+HREF="#AEN994"
 >OS9 Modules</A
 ></DT
 ></DL
@@ -245,14 +245,14 @@
 ></DD
 ><DT
 >5. <A
-HREF="#AEN1001"
+HREF="#AEN1006"
 >Libraries and LWAR</A
 ></DT
 ><DD
 ><DL
 ><DT
 >5.1. <A
-HREF="#AEN1005"
+HREF="#AEN1010"
 >Command Line Options</A
 ></DT
 ></DL
@@ -274,12 +274,12 @@
 ></DT
 ><DT
 >6-1. <A
-HREF="#AEN1088"
+HREF="#AEN1093"
 >Object File Term Types</A
 ></DT
 ><DT
 >6-2. <A
-HREF="#AEN1118"
+HREF="#AEN1123"
 >Object File Operator Numbers</A
 ></DT
 ></DL
@@ -2512,6 +2512,19 @@
 applies when the assembler is left to guess what the operand size is.</P
 ></DD
 ><DT
+>operandsizewarning</DT
+><DD
+><P
+>Enabling this pragma will cause LWASM to show a warning when it
+detects that a smaller addressing mode could be used for an instruction.
+This is particularly useful for finding places where long branches are used
+where short branches could be used instead. It will also show the warnings
+for indexing offsets (regardless of whether the operand size is
+forced).</P
+><P
+>As of LWASM 4.16, no other checks are performed.</P
+></DD
+><DT
 >qrts</DT
 ><DD
 ><P
@@ -2616,7 +2629,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN800"
+NAME="AEN805"
 >3.12. Cycle Counts</A
 ></H2
 ><P
@@ -2655,7 +2668,7 @@
 CLASS="CHAPTER"
 ><HR><H1
 ><A
-NAME="AEN806"
+NAME="AEN811"
 ></A
 >Chapter 4. LWLINK</H1
 ><P
@@ -2666,7 +2679,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN809"
+NAME="AEN814"
 >4.1. Command Line Options</A
 ></H2
 ><P
@@ -2864,7 +2877,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN906"
+NAME="AEN911"
 >4.2. Linker Operation</A
 ></H2
 ><P
@@ -2920,7 +2933,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN920"
+NAME="AEN925"
 >4.3. Linking Scripts</A
 ></H2
 ><P
@@ -3124,7 +3137,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN986"
+NAME="AEN991"
 >4.4. Format Specific Linking Notes</A
 ></H2
 ><P
@@ -3137,7 +3150,7 @@
 ><HR><H3
 CLASS="SECTION"
 ><A
-NAME="AEN989"
+NAME="AEN994"
 >4.4.1. OS9 Modules</A
 ></H3
 ><P
@@ -3213,7 +3226,7 @@
 CLASS="CHAPTER"
 ><HR><H1
 ><A
-NAME="AEN1001"
+NAME="AEN1006"
 ></A
 >Chapter 5. Libraries and LWAR</H1
 ><P
@@ -3232,7 +3245,7 @@
 ><HR><H2
 CLASS="SECTION"
 ><A
-NAME="AEN1005"
+NAME="AEN1010"
 >5.1. Command Line Options</A
 ></H2
 ><P
@@ -3433,7 +3446,7 @@
 ><DIV
 CLASS="TABLE"
 ><A
-NAME="AEN1088"
+NAME="AEN1093"
 ></A
 ><P
 ><B
@@ -3505,7 +3518,7 @@
 ><DIV
 CLASS="TABLE"
 ><A
-NAME="AEN1118"
+NAME="AEN1123"
 ></A
 ><P
 ><B