Merge pull request scala/scala#10985 from lrytz/nowarnV

Show nowarn / Wconf filters for a warning with  @nowarn("verbose")

Author: lrytz

library/src/scala/annotation/nowarn.scala

@@ -14,15 +14,21 @@ package scala.annotation
 
 /** An annotation for local warning suppression.
   *
-  * The optional `value` parameter allows selectively silencing messages, see `scalac -Wconf:help`
-  * for help. Examples:
+  * The optional `value` parameter allows selectively silencing messages. See `-Wconf:help` for help
+  * writing a message filter expression, or use `@nowarn("verbose")` / `@nowarn("v")` to display message
+  * filters applicable to a specific warning.
+  *
+  * Examples:
   *
   * {{{
   *   def f = {
   *     1: @nowarn // don't warn "a pure expression does nothing in statement position"
   *     2
   *   }
   *
+  *   // show the warning, plus the applicable @nowarn / Wconf filters ("cat=other-pure-statement", ...)
+  *   @nowarn("v") def f = { 1; 2 }
+  *
   *   @nowarn def f = { 1; deprecated() } // don't warn
   *
   *   @nowarn("msg=pure expression does nothing")