diff --git a/src/comments.md b/src/comments.md
index ef283a9ea1..2e8f5aa41c 100644
--- a/src/comments.md
+++ b/src/comments.md
@@ -20,9 +20,7 @@ BLOCK_COMMENT ->
       `/**/`
     | `/***/`
     | `/*`
-        ^
-        ( ~[`*` `!`] | `**` | BLOCK_COMMENT_OR_DOC )
-        ( BLOCK_COMMENT_OR_DOC | ~`*/` )*
+        ^ ( BLOCK_COMMENT_OR_DOC | ~`*/` )*
       `*/`
 
 INNER_LINE_DOC ->
@@ -46,9 +44,9 @@ OUTER_BLOCK_DOC ->
 BLOCK_CHAR -> (!(`*/` | CR) CHAR)
 
 BLOCK_COMMENT_OR_DOC ->
-      BLOCK_COMMENT
+      INNER_BLOCK_DOC
     | OUTER_BLOCK_DOC
-    | INNER_BLOCK_DOC
+    | BLOCK_COMMENT
 ```
 
 r[comments.normal]