auto merge of #15121 : steveklabnik/rust/matching_docs, r=alexcrichton

Fixes #11113.

diff --git a/src/doc/tutorial.md b/src/doc/tutorial.md
index d4f446b29334ffb17d756d1dae8c804262d0a3cc..65ed2680dd654d493b5b7949b21e0ac0ac62b580 100644 (file)
--- a/src/doc/tutorial.md
+++ b/src/doc/tutorial.md
@@ -566,9 +566,14 @@ tuple, introducing two variables at once: `a` and `b`.
 let (a, b) = get_tuple_of_two_ints();
 ~~~~
 
-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.
+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 as binding patterns, since most such patterns are not irrefutable. For
+example, this will not compile:
+
+~~~~{ignore}
+let (a, 2) = (1, 2);
+~~~~
 
 ## Loops