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 7f1421db34b8b9fc31cba87f63ac1edb32e3eb1e..b056445e315b4edf66a750c85f6bca408b162b7d 100644 (file)
--- 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.