Added info about the new .sprintf function

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

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index b056445e315b4edf66a750c85f6bca408b162b7d..b1fd5779f50c69cf05bae1c2e74cbde5d0eab130 100644 (file)
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -1498,6 +1498,25 @@ either a string or an expression.
   </verb></tscreen>
 
 
+<sect1><tt>.SPRINTF</tt><label id=".SPRINTF"><p>
+
+  Builtin function. It expects a format string as first argument. The number
+  and type of the following arguments depend on the format string. The format
+  string is similar to the one of the C <tt/printf/ function. Missing things
+  are: Length modifiers, variable width.
+
+  The result of the function is a string.
+
+  Example:
+
+  <tscreen><verb>
+        num     = 3
+
+        ; Generate an identifier:
+        .ident (.sprintf ("%s%03d", "label", num)):
+  </verb></tscreen>
+
+
 <sect1><tt>.STRING</tt><label id=".STRING"><p>
 
   Builtin function. The function accepts an argument in braces and converts