2 files changed, 8 insertions, 9 deletions

diff --git a/crates/ra_syntax/src/ast/generated/nodes.rs b/crates/ra_syntax/src/ast/generated/nodes.rs
index 72977a3c6..22de5aae4 100644
--- a/crates/ra_syntax/src/ast/generated/nodes.rs
+++ b/crates/ra_syntax/src/ast/generated/nodes.rs
@@ -1515,9 +1515,9 @@ impl ParenPat {
 ///
 /// ```
 /// let ❰ &mut foo ❱ = bar;
+///
+/// let ❰ & ❰ &mut ❰ &_ ❱ ❱ ❱ = baz;
 /// ```
-/// // TODO: clarify on the special case of double reference pattern
-/// // described in the link bellow
 ///
 /// [Reference](https://doc.rust-lang.org/reference/patterns.html#reference-patterns)
 #[derive(Debug, Clone, PartialEq, Eq, Hash)]
@@ -2069,14 +2069,12 @@ pub struct Abi {
 }
 impl Abi {}
 /// Expression statement.
-/// Note: may be empty (i.e. only semicolon).
 ///
 /// ```
 /// ❰ 42; ❱
 /// ❰ foo(); ❱
 /// ❰ (); ❱
 /// ❰ {}; ❱
-/// ❰ /* empty */; ❱
 ///
 /// // constructions with trailing curly brace can omit the semicolon // TODO: clarify
 /// ❰ if bool_cond { } ❱
@@ -2707,6 +2705,8 @@ pub enum AttrInput {
     TokenTree(TokenTree),
 }
 /// Any kind of statement
+/// Note: there are no empty statements, these are just represented as
+/// bare semicolons without a dedicated statement ast node.
 #[derive(Debug, Clone, PartialEq, Eq, Hash)]
 pub enum Stmt {
     LetStmt(LetStmt),
diff --git a/xtask/src/ast_src.rs b/xtask/src/ast_src.rs
index 821b13378..deb9f690d 100644
--- a/xtask/src/ast_src.rs
+++ b/xtask/src/ast_src.rs
@@ -1349,9 +1349,9 @@ pub(crate) const AST_SRC: AstSrc = AstSrc {
         ///
         /// ```
         /// let ❰ &mut foo ❱ = bar;
+        ///
+        /// let ❰ & ❰ &mut ❰ &_ ❱ ❱ ❱ = baz;
         /// ```
-        /// // TODO: clarify on the special case of double reference pattern
-        /// // described in the link bellow
         ///
         /// [Reference](https://doc.rust-lang.org/reference/patterns.html#reference-patterns)
         struct RefPat { T![&], T![mut], Pat }
@@ -1714,16 +1714,13 @@ pub(crate) const AST_SRC: AstSrc = AstSrc {
         /// - [FFI function pointers reference](https://doc.rust-lang.org/reference/items/functions.html#functions)
         struct Abi { /*String*/ }
 
-        // TODO: clarify how empty statements are handled
         /// Expression statement.
-        /// Note: may be empty (i.e. only semicolon).
         ///
         /// ```
         /// ❰ 42; ❱
         /// ❰ foo(); ❱
         /// ❰ (); ❱
         /// ❰ {}; ❱
-        /// ❰ /* empty */; ❱
         ///
         /// // constructions with trailing curly brace can omit the semicolon // TODO: clarify
         /// ❰ if bool_cond { } ❱
@@ -2201,6 +2198,8 @@ pub(crate) const AST_SRC: AstSrc = AstSrc {
         enum AttrInput { Literal, TokenTree }
 
         /// Any kind of statement
+        /// Note: there are no empty statements, these are just represented as
+        /// bare semicolons without a dedicated statement ast node.
         enum Stmt {
             LetStmt,
             ExprStmt,