diff --git a/doc/cql3/CQL.textile b/doc/cql3/CQL.textile
index 9a24ec0d0f..f63b6b8709 100644
--- a/doc/cql3/CQL.textile
+++ b/doc/cql3/CQL.textile
@@ -61,9 +61,13 @@ h3. Comments
 
 A comment in CQL is a line beginning by either double dashes (@--@) or double slash (@//@).
 
+Multi-line comments are also supported through enclosure withing @/*@ and @*/@ (but nesting is not supported).
+
 bc(sample). 
 -- This is a comment
 // This is a comment too
+/* This is
+   a multiline comment */
 
 h3(#statements). Statements