---

yaml
---
r: 30727
b: refs/heads/incoming
c: ba8750a
h: refs/heads/master
i:
  30725: beaaf8c
  30723: 8eb1bab
  30719: 6c92920
v: v3

Author: brson

[refs]

@@ -6,7 +6,7 @@ refs/heads/try: d324a424d8f84b1eb049b12cf34182bda91b0024
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b
 refs/heads/try2: d0c6ce338884ee21843f4b40bf6bf18d222ce5df
-refs/heads/incoming: a8406e3d00ca791317f85d369e6157e4b5a2cf90
+refs/heads/incoming: ba8750a5503242828ca0d95177196ebe6d7cbf51
 refs/heads/dist-snap: 2f32a1581f522e524009138b33b1c7049ced668d
 refs/tags/release-0.2: c870d2dffb391e14efb05aa27898f1f6333a9596
 refs/tags/release-0.3: b5f0d0f648d9a6153664837026ba1be43d3e2503

branches/incoming/doc/tutorial.md

@@ -580,8 +580,8 @@ you use the matching to get at the contents of data types. Remember
 that `(float, float)` is a tuple of two floats:
 
 ~~~~
-use float::consts::pi;
 fn angle(vector: (float, float)) -> float {
+    let pi = float::consts::pi;
     match vector {
       (0f, y) if y < 0f => 1.5 * pi,
       (0f, y) => 0.5 * pi,
@@ -601,23 +601,19 @@ an expression of type `bool` that determines, after the pattern is
 found to match, whether the arm is taken or not. The variables bound
 by the pattern are available in this guard expression.
 
-## Let
-
-You've already seen simple `let` bindings. `let` is also a little fancier: it
-is possible to use destructuring patterns in it. For example, you can say this
-to extract the fields from a tuple:
+You've already seen simple `let` bindings, but `let` is a little
+fancier than you've been led to believe. It too supports destructuring
+patterns. For example, you can say this to extract the fields from a
+tuple, introducing two variables, `a` and `b`.
 
 ~~~~
 # fn get_tuple_of_two_ints() -> (int, int) { (1, 1) }
 let (a, b) = get_tuple_of_two_ints();
 ~~~~
 
-This will introduce two new variables, `a` and `b`, bound to the
-content of the tuple.
-
-You may only use *irrefutable* patterns—patterns that can never fail to
-match—in let bindings. Other types of patterns, such as literals, are
-not allowed.
+Let bindings only work with _irrefutable_ patterns, that is, patterns
+that can never fail to match. This excludes `let` from matching
+literals and most enum variants.
 
 ## Loops