From: uz <uz@b7a2c559-68d2-44c3-8de9-860c34a00d81>
Date: Thu, 21 Aug 2008 19:42:52 +0000 (+0000)
Subject: Document the new c_comments feature.
X-Git-Tag: V2.13.0rc1~365
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=f1e0de512a2a17e4462af0f5cc3456a1dec90ed8;p=cc65

Document the new c_comments feature.


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

diff --git a/doc/ca65.sgml b/doc/ca65.sgml
index 4f792131e..96c5989f2 100644
--- a/doc/ca65.sgml
+++ b/doc/ca65.sgml
@@ -2236,6 +2236,19 @@ Here's a list of all control commands and a description, what they do:
     at character is not allowed to start an identifier, even with this
     feature enabled.
 
+  <tag><tt>c_comments</tt></tag>
+
+    Allow C like comments using <tt>/*</tt> and <tt>*/</tt> as left and right
+    comment terminators. Note that C comments may not be nested. There's also a
+    pitfall when using C like comments: All statements must be terminated by
+    "end-of-line". Using C like comments, it is possible to hide the newline,
+    which results in error messages. See the following non working example:
+
+    <tscreen><verb>
+        lda     #$00  /* This comment hides the newline
+*/      sta     $82
+    </verb></tscreen>
+
   <tag><tt>dollar_in_identifiers</tt></tag>
 
     Accept the dollar sign (`&dollar;') as a valid character in identifiers. The