2 files changed, 6 insertions, 2 deletions

diff --git a/crates/ra_syntax/src/ast/generated/nodes.rs b/crates/ra_syntax/src/ast/generated/nodes.rs
index 22de5aae4..9254e4fd4 100644
--- a/crates/ra_syntax/src/ast/generated/nodes.rs
+++ b/crates/ra_syntax/src/ast/generated/nodes.rs
@@ -2076,9 +2076,11 @@ impl Abi {}
 /// ❰ (); ❱
 /// ❰ {}; ❱
 ///
-/// // constructions with trailing curly brace can omit the semicolon // TODO: clarify
+/// // constructions with trailing curly brace can omit the semicolon
+/// // but only when there are satements immediately after them (this is important!)
 /// ❰ if bool_cond { } ❱
 /// ❰ loop {} ❱
+/// ❰ somestatment; ❱
 /// ```
 ///
 /// [Reference](https://doc.rust-lang.org/reference/statements.html)
diff --git a/xtask/src/ast_src.rs b/xtask/src/ast_src.rs
index 405f6b337..a1dc2ce46 100644
--- a/xtask/src/ast_src.rs
+++ b/xtask/src/ast_src.rs
@@ -1722,9 +1722,11 @@ pub(crate) const AST_SRC: AstSrc = AstSrc {
         /// ❰ (); ❱
         /// ❰ {}; ❱
         ///
-        /// // constructions with trailing curly brace can omit the semicolon // TODO: clarify
+        /// // constructions with trailing curly brace can omit the semicolon
+        /// // but only when there are satements immediately after them (this is important!)
         /// ❰ if bool_cond { } ❱
         /// ❰ loop {} ❱
+        /// ❰ somestatment; ❱
         /// ```
         ///
         /// [Reference](https://doc.rust-lang.org/reference/statements.html)