From eb61bf32f91b1cd4c7dd3202f8645b40f6e6a70a Mon Sep 17 00:00:00 2001
From: Stephan Herrmann <stephan.herrmann@berlin.de>
Date: Tue, 21 Apr 2026 21:39:08 +0200
Subject: [PATCH] Update documentation of SuppressWarnings tokens + new doc for
 "exports", "module" and "preview" + fix ordering regarding "removal",
 "unlikely-arg-type" + minor additions and corrections here and there

---
 .../tasks/task-suppress_warnings.htm          | 76 ++++++++++++++-----
 1 file changed, 58 insertions(+), 18 deletions(-)

diff --git a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
index 06ec81b14fe..b7c7e8302e6 100644
--- a/eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
+++ b/eclipse.platform.common/bundles/org.eclipse.jdt.doc.user/tasks/task-suppress_warnings.htm
@@ -87,7 +87,21 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 		<p>to suppress warnings relative to deprecation</p>
 		</td>
 		<td>
-		<p>Deprecated API</p>
+		<p>Usage of deprecated API</p>
+		</td>
+	</tr>
+	<tr>
+		<td>
+		<p><span class="token">exports</span></p>
+		</td>
+		<td>
+		<p>to suppress warnings relative to module API leaks</p>
+		</td>
+		<td>
+		<p>Public API exposes a type that is not exported<br/>
+		Public API exposes a non-public type<br/>
+		Public API exposes a type from another module that is not transitively required
+		</p>
 		</td>
 	</tr>
 	<tr>
@@ -145,6 +159,17 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 		<p>All options in <a href="../reference/preferences/java/compiler/ref-preferences-javadoc.htm">Java Compiler Javadoc Preferences</a></p>
 		</td>
 	</tr>
+	<tr>
+		<td>
+		<p><span class="token">module</span></p>
+		</td>
+		<td>
+		<p>to suppress warnings relative to modules</p>
+		</td>
+		<td>
+		<p>An automatic module has an unstable name</p>
+		</td>
+	</tr>
 	<tr>
 		<td>
 		<p><span class="token">nls</span></p>
@@ -167,6 +192,18 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 		<p>All options in <a href="../reference/preferences/java/compiler/ref-preferences-errors-warnings.htm#null_analysis">Java Compile Errors/Warnings Preferences for Null Analysis</a></p>
 		</td>
 	</tr>
+	<tr>
+		<td>
+		<p><span class="token">preview</span></p>
+		</td>
+		<td>
+		<p>to suppress warnings relative to preview features</p>
+		</td>
+		<td>
+		<p>Use of a preview language feature</p>
+		<p>Use of a preview API</p>
+		</td>
+	</tr>
 	<tr>
 		<td>
 		<p><span class="token">rawtypes</span></p>
@@ -180,35 +217,35 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 	</tr>
 	<tr>
 		<td>
-		<p><span class="token">resource</span></p>
+		<p><span class="token">removal</span></p>
 		</td>
 		<td>
-		<p>to suppress warnings relative to usage of resources of type Closeable</p>
+		<p>to suppress warnings relative to usage of terminally deprecated API</p>
 		</td>
 		<td>
-		<p>Resource leak<br/>
-		Potential resource leak<br/>
-		Resource not managed via try-with-resource</p>
+		<p>Usage of terminally deprecated API</p>
 		</td>
 	</tr>
 	<tr>
 		<td>
-		<p><span class="token">restriction</span></p>
+		<p><span class="token">resource</span></p>
 		</td>
 		<td>
-		<p>to suppress warnings relative to usage of discouraged or forbidden references</p>
+		<p>to suppress warnings relative to usage of resources of type Closeable</p>
 		</td>
 		<td>
-		<p>Forbidden reference (access rules)<br/>
-		Discouraged reference (access rules)</p>
+		<p>Resource leak<br/>
+		Potential resource leak<br/>
+		Resource not managed via try-with-resource<br/>
+		Specification using '@Owning'/'@NotOwning' is insufficient</p>
 		</td>
 	</tr>
 	<tr>
 		<td>
-		<p><span class="token">removal</span></p>
+		<p><span class="token">restriction</span></p>
 		</td>
 		<td>
-		<p>to suppress warnings relative to usage of terminally deprecated API</p>
+		<p>to suppress warnings relative to usage of discouraged or forbidden references</p>
 		</td>
 		<td>
 		<p>Forbidden reference (access rules)<br/>
@@ -294,21 +331,21 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 	</tr>
 	<tr>
 		<td>
-		<p><span class="token">unqualified-field-access</span></p>
+		<p><span class="token">unlikely-arg-type</span></p>
 		</td>
 		<td>
-		<p>to suppress warnings relative to field access unqualified</p>
+		<p>to suppress warnings relative to unlikely argument types</p>
 		</td>
 		<td>
-		<p>Unqualified access to instance field</p>
+		<p>Collection method with 'Object' parameter is called with an argument that may never match</p>
 		</td>
 	</tr>
 	<tr>
 		<td>
-		<p><span class="token">unlikely-arg-type</span></p>
+		<p><span class="token">unqualified-field-access</span></p>
 		</td>
 		<td>
-		<p>to suppress warnings relative to unlikely argument types</p>
+		<p>to suppress warnings relative to field access unqualified</p>
 		</td>
 		<td>
 		<p>Unqualified access to instance field</p>
@@ -330,7 +367,10 @@ <h1>Excluding Warnings Using @SuppressWarnings</h1>
 		Unused type parameter<br/>
 		Unused import<br/>
 		Unused private member<br/>
-		Unused 'break' or 'continue' label
+		Unused 'break' or 'continue' label<br/>
+		Redundant super interface specification<br/>
+		Unnecessary specification of type arguments<br/>
+		Method declares 'throws' but exception is not thrown<br/>
 		</p>
 		</td>
 	</tr>