Document universal &mut reborrows

src/expressions.md

@@ -190,6 +190,24 @@ An *assignee expression* is an expression that appears in the left operand of an
 r[expr.place-value.parenthesis]
 Arbitrary parenthesisation is permitted inside assignee expressions.
 
+r[expr.mut]
+### Mutability
+
+r[expr.mut.intro]
+For a place expression to be [assigned][assign] to, mutably [borrowed][borrow], [implicitly mutably borrowed], or bound to a pattern containing `ref mut`, it must be _mutable_. We call these *mutable place expressions*. In contrast, other place expressions are called *immutable place expressions*.
+
+r[expr.mut.valid-places]
+The following expressions can be mutable place expression contexts:
+
+* Mutable [variables] which are not currently borrowed.
+* [Mutable `static` items].
+* [Temporary values].
+* [Fields][field]: this evaluates the subexpression in a mutable place expression context.
+* [Dereferences][deref] of a `*mut T` pointer.
+* Dereference of a variable, or field of a variable, with type `&mut T`. Note: This is an exception to the requirement of the next rule.
+* Dereferences of a type that implements `DerefMut`: this then requires that the value being dereferenced is evaluated in a mutable place expression context.
+* [Array indexing] of a type that implements `IndexMut`: this then evaluates the value being indexed, but not the index, in mutable place expression context.
+
 r[expr.move]
 ### Moved and copied types
 
@@ -199,6 +217,9 @@ When a place expression is evaluated in a value expression context, or is bound
 r[expr.move.copy]
 If the type of that value implements [`Copy`], then the value will be copied.
 
+r[expr.move.mut-ref]
+If the type of that value is `&mut T`, and the place expression is mutable, then the value will be reborrowed. This is equivalent to applying `&mut *` (a [dereference][deref] and then a [mutable borrow][borrow]) to the place.
+
 r[expr.move.requires-sized]
 In the remaining situations, if that type is [`Sized`], then it may be possible to move the value.
 
@@ -216,24 +237,6 @@ After moving out of a place expression that evaluates to a local variable, the l
 r[expr.move.place-invalid]
 In all other cases, trying to use a place expression in a value expression context is an error.
 
-r[expr.mut]
-### Mutability
-
-r[expr.mut.intro]
-For a place expression to be [assigned][assign] to, mutably [borrowed][borrow], [implicitly mutably borrowed], or bound to a pattern containing `ref mut`, it must be _mutable_. We call these *mutable place expressions*. In contrast, other place expressions are called *immutable place expressions*.
-
-r[expr.mut.valid-places]
-The following expressions can be mutable place expression contexts:
-
-* Mutable [variables] which are not currently borrowed.
-* [Mutable `static` items].
-* [Temporary values].
-* [Fields][field]: this evaluates the subexpression in a mutable place expression context.
-* [Dereferences][deref] of a `*mut T` pointer.
-* Dereference of a variable, or field of a variable, with type `&mut T`. Note: This is an exception to the requirement of the next rule.
-* Dereferences of a type that implements `DerefMut`: this then requires that the value being dereferenced is evaluated in a mutable place expression context.
-* [Array indexing] of a type that implements `IndexMut`: this then evaluates the value being indexed, but not the index, in mutable place expression context.
-
 r[expr.temporary]
 ### Temporaries