Auto merge of rust-lang#6048 - giraffate:add_note_to_shadow_unrelated…

…, r=matthiaskrgr

Add note to `shadow_unrelated`

Fix rust-lang#5455.

This lint can be disabled at function level.

changelog: none

clippy_lints/src/shadow.rs

@@ -74,7 +74,9 @@ declare_clippy_lint! {
     /// names to bindings or introducing more scopes to contain the bindings.
     ///
     /// **Known problems:** This lint, as the other shadowing related lints,
-    /// currently only catches very simple patterns.
+    /// currently only catches very simple patterns. Note that
+    /// `allow`/`warn`/`deny`/`forbid` attributes only work on the function level
+    /// for this lint.
     ///
     /// **Example:**
     /// ```rust