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

Fixes #11113.

1 files changed, 8 insertions, 3 deletions

diff --git a/src/doc/tutorial.md b/src/doc/tutorial.md
index d4f446b2933..65ed2680dd6 100644
--- 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