From 483668b0f69c3c9752d86c27871f5868144349a9 Mon Sep 17 00:00:00 2001
From: Wesley Wiser <wwiser@gmail.com>
Date: Sun, 20 Dec 2020 21:44:27 -0500
Subject: [PATCH] Add example to lint docs

---
 compiler/rustc_lint_defs/src/builtin.rs | 30 ++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/compiler/rustc_lint_defs/src/builtin.rs b/compiler/rustc_lint_defs/src/builtin.rs
index 242b2ce9e0697..ad53f2375779b 100644
--- a/compiler/rustc_lint_defs/src/builtin.rs
+++ b/compiler/rustc_lint_defs/src/builtin.rs
@@ -1229,12 +1229,40 @@ declare_lint! {
 }
 
 declare_lint! {
-    /// The missing_fragment_specifier warning is issued when an unused pattern in a
+    /// The `missing_fragment_specifier` lint is issued when an unused pattern in a
     /// `macro_rules!` macro definition has a meta-variable (e.g. `$e`) that is not
     /// followed by a fragment specifier (e.g. `:expr`).
     ///
     /// This warning can always be fixed by removing the unused pattern in the
     /// `macro_rules!` macro definition.
+    ///
+    /// ### Example
+    ///
+    /// ```rust,compile_fail
+    /// macro_rules! foo {
+    ///    () => {};
+    ///    ($name) => { };
+    /// }
+    ///
+    /// fn main() {
+    ///    foo!();
+    /// }
+    /// ```
+    ///
+    /// {{produces}}
+    ///
+    /// ### Explanation
+    ///
+    /// To fix this, remove the unused pattern from the `macro_rules!` macro definition:
+    ///
+    /// ```rust
+    /// macro_rules! foo {
+    ///     () => {};
+    /// }
+    /// fn main() {
+    ///     foo!();
+    /// }
+    /// ```
     pub MISSING_FRAGMENT_SPECIFIER,
     Deny,
     "detects missing fragment specifiers in unused `macro_rules!` patterns",