Merge pull request #369 from crlf0710/patch-1

[RFC 231] Capture mode and closure trait rules

Author: alercah

src/expressions/closure-expr.md

@@ -24,9 +24,9 @@ Closure expressions are most useful when passing functions as arguments to other
 functions, as an abbreviation for defining and capturing a separate function.
 
 Significantly, closure expressions _capture their environment_, which regular
-[function definitions] do not. Without the `move`
-keyword, the closure expression infers how it captures each variable from its
-environment, preferring to capture by shared reference, effectively borrowing
+[function definitions] do not. Without the `move` keyword, the closure expression
+[infers how it captures each variable from its environment](types.html#capture-modes),
+preferring to capture by shared reference, effectively borrowing
 all outer variables mentioned inside the closure's body. If needed the compiler
 will infer that instead mutable references should be taken, or that the values
 should be moved or copied (depending on their type) from the environment. A
@@ -35,7 +35,7 @@ prefixing it with the `move` keyword. This is often used to ensure that the
 closure's type is `'static`.
 
 The compiler will determine which of the [closure
-traits](types.html#closure-types) the closure's type will implement by how it
+traits](types.html#call-traits-and-coercions) the closure's type will implement by how it
 acts on its captured variables. The closure will also implement
 [`Send`](special-types-and-traits.html#send) and/or
 [`Sync`](special-types-and-traits.html#sync) if all of its captured types do.

src/types.md

@@ -414,6 +414,8 @@ so that the call to `f` works as if it were:
 f(Closure{s: s, t: &t});
 ```
 
+### Capture modes
+
 The compiler prefers to capture a closed-over variable by immutable borrow,
 followed by unique immutable borrow (see below), by mutable borrow, and finally
 by move. It will pick the first choice of these that allows the closure to