From: JT <jeremiah.turner@gmail.com>
Date: Mon, 20 Apr 2015 22:56:34 +0000 (-0400)
Subject: Updated documentation for .ADDRSIZE and .FEATURE addrsize
X-Git-Tag: V2.15~11^2~2^2~1
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=499eab65f1d31b8e2e3cb00cb88f5c51c8d7585c;p=cc65

Updated documentation for .ADDRSIZE and .FEATURE addrsize
---

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index fa3258562..0dc6e902d 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -1278,6 +1278,36 @@ writable.
 Pseudo functions expect their arguments in parenthesis, and they have a result,
 either a string or an expression.
 
+<sect1><tt>.ADDRSIZE</tt><label id=".ADDRSIZE"><p>
+
+  The <tt/.ADDRSIZE/ function is used to return the interal address size 
+  associated with a symbol. This can be helpful in macros when knowing address 
+  size of symbol can allow for custom instructions.
+
+  Example:
+
+  <tscreen><verb>
+        
+        .macro myLDA foo
+
+  	        .if .ADDRSIZE(foo) = 1
+  	          	        ;do custom command based on zeropage addressing:
+  	          	        .byte .A5h, foo
+  	        .elseif .ADDRSIZE(foo) = 2
+  	          	        ;do custom command based on absolute addressing:
+  	          	        .byte .ADh, foo
+  	        .elseif .ADDRSIZE(foo) = 0
+  	          	        ; no address size define for this symbol:
+  	          	        .out .sprinft("Error, address size unknown for symbol %s", .string(foo))
+  	        .endif
+        .endmacro
+  </verb></tscreen>
+
+  This command is new and must be enabled with the <tt/.FEATURE addrsize/ command.
+
+  See: <tt><ref id=".FEATURE" name=".FEATURE"></tt>
+
+
 
 <sect1><tt>.BANK</tt><label id=".BANK"><p>
 
@@ -2596,6 +2626,12 @@ Here's a list of all control commands and a description, what they do:
 
   <descrip>
 
+  <tag><tt>addrsize</tt><label id="addrsize"></tag>
+
+    Enables the .ADDRSIZE pseudo function. This function is experimental and not enabled by default.
+
+    See also: <tt><ref id=".ADDRSIZE" name=".ADDRSIZE"></tt>
+
   <tag><tt>at_in_identifiers</tt><label id="at_in_identifiers"></tag>
 
     Accept the at character (`@') as a valid character in identifiers. The
@@ -2648,11 +2684,6 @@ Here's a list of all control commands and a description, what they do:
     overridden. When using this feature, you may also get into trouble if
     later versions of the assembler define new keywords starting with a dot.
 
-  <tag><tt>loose_char_term</tt><label id="loose_char_term"></tag>
-
-    Accept single quotes as well as double quotes as terminators for char
-    constants.
-
   <tag><tt>loose_string_term</tt><label id="loose_string_term"></tag>
 
     Accept single quotes as well as double quotes as terminators for string