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

lrytz · web-flow · commit ba2055e99425 · 2025-01-30T13:32:51.000+01:00
Show nowarn / Wconf filters for a warning with @nowarn("verbose")
diff --git a/library/src/scala/annotation/nowarn.scala b/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")

Original file line number	Diff line number	Diff line change
`@@ -14,15 +14,21 @@ package scala.annotation`
`14`	`14`
`15`	`15`	`/** An annotation for local warning suppression.`
`16`	`16`	`*`
`17`		- * The optional `value` parameter allows selectively silencing messages, see `scalac -Wconf:help`
`18`		`- * for help. Examples:`
	`17`	+ * The optional `value` parameter allows selectively silencing messages. See `-Wconf:help` for help
	`18`	+ * writing a message filter expression, or use `@nowarn("verbose")` / `@nowarn("v")` to display message
	`19`	`+ * filters applicable to a specific warning.`
	`20`	`+ *`
	`21`	`+ * Examples:`
`19`	`22`	`*`
`20`	`23`	`* {{{`
`21`	`24`	`* def f = {`
`22`	`25`	`* 1: @nowarn // don't warn "a pure expression does nothing in statement position"`
`23`	`26`	`* 2`
`24`	`27`	`* }`
`25`	`28`	`*`
	`29`	`+ * // show the warning, plus the applicable @nowarn / Wconf filters ("cat=other-pure-statement", ...)`
	`30`	`+ * @nowarn("v") def f = { 1; 2 }`
	`31`	`+ *`
`26`	`32`	`* @nowarn def f = { 1; deprecated() } // don't warn`
`27`	`33`	`*`
`28`	`34`	`* @nowarn("msg=pure expression does nothing")`