Resolve TODO about curly-braced constructions in expression statement

Author: Veetaha

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)

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)