From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Mon, 9 May 2005 19:06:26 +0000 (+0000)
Subject: Documented the new .IDENT function
X-Git-Tag: V2.12.0~334
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=22e204d1c4e66f49f5d08a4227712e0e564da415;p=cc65

Documented the new .IDENT function


git-svn-id: svn://svn.cc65.org/cc65/trunk@3507 b7a2c559-68d2-44c3-8de9-860c34a00d81
---

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index 7f1421db3..b056445e3 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -1199,6 +1199,26 @@ either a string or an expression.
   See: <tt><ref id=".LOWORD" name=".LOWORD"></tt>
 
 
+<sect1><tt>.IDENT</tt><label id=".IDENT"><p>
+
+  The function expects a string as its argument, and converts this argument
+  into an identifier. If the string starts with the current <tt/<ref
+  id=".LOCALCHAR" name=".LOCALCHAR">/, it will be converted into a cheap local
+  identifier, otherwise it will be converted into a normal identifier.
+
+  Example:
+
+  <tscreen><verb>
+    	.macro 	makelabel       arg1, arg2
+                .ident (.concat (arg1, arg2)):
+        .endmacro
+
+                makelabel       "foo", "bar"
+
+                .word           foobar          ; Valid label
+  </verb></tscreen>
+
+
 <sect1><tt>.LEFT</tt><label id=".LEFT"><p>
 
   Builtin function. Extracts the left part of a given token list.