From 22e204d1c4e66f49f5d08a4227712e0e564da415 Mon Sep 17 00:00:00 2001
From: cuz <cuz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Mon, 9 May 2005 19:06:26 +0000
Subject: [PATCH] Documented the new .IDENT function

git-svn-id: svn://svn.cc65.org/cc65/trunk@3507 b7a2c559-68d2-44c3-8de9-860c34a00d81
---
 doc/ca65.sgml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

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.
-- 
2.39.5