Issue checkstyle#7179: Update documentation of filters to reference t…

…argets of suppression

src/main/java/com/puppycrawl/tools/checkstyle/filters/SeverityMatchFilter.java

@@ -29,6 +29,9 @@
  * Filter {@code SeverityMatchFilter} decides audit events according to the
  * <a href="https://checkstyle.org/config.html#Severity">severity level</a> of the event.
  * </p>
+ * <p>
+ * SeverityMatchFilter can suppress Checks that have Treewalker or Checker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code severity} - Specify the severity level of this filter.

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressWarningsFilter.java

@@ -46,6 +46,10 @@
  * any dotted prefix or "Check" suffix removed.
  * </p>
  * <p>
+ * SuppressWarningsFilter can suppress Checks that have Treewalker or
+ * Checker as parent module.
+ * </p>
+ * <p>
  * To configure the check that makes tha annotations available to the filter.
  * </p>
  * <pre>

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressWithNearbyCommentFilter.java

@@ -52,6 +52,10 @@
  * a <a href="https://checkstyle.org/config_filters.html#SuppressWithPlainTextCommentFilter">
  * SuppressWithPlainTextCommentFilter</a> or similar filter must be used.
  * </p>
+ * <p>
+ * SuppressWithNearbyCommentFilter can suppress Checks that have
+ * Treewalker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code commentFormat} - Specify comment pattern to trigger filter to begin suppression.

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressWithPlainTextCommentFilter.java

@@ -68,6 +68,10 @@
  * <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Matcher.html#groupCount()">
  * paren counts</a>.
  * </p>
+ * <p>
+ * SuppressionWithPlainTextCommentFilter can suppress Checks that have Treewalker or
+ * Checker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code offCommentFormat} - Specify comment pattern to trigger filter

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressionCommentFilter.java

@@ -65,6 +65,9 @@
  * <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Matcher.html#groupCount()">
  * paren counts</a>.
  * </p>
+ * <p>
+ * SuppressionCommentFilter can suppress Checks that have Treewalker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code offCommentFormat} - Specify comment pattern to

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressionFilter.java

@@ -104,6 +104,9 @@
  * if no file found, then passed to the {@code ClassLoader.getResource()} method.
  * </li>
  * </ol>
+ * <p>
+ * SuppressionFilter can suppress Checks that have Treewalker or Checker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code file} - Specify the location of the <em>suppressions XML document</em> file.

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressionSingleFilter.java

@@ -43,6 +43,10 @@
  * Attention: This filter only supports single suppression, and will need multiple instances if
  * users wants to suppress multiple violations.
  * </p>
+ * <p>
+ * SuppressionSingleFilter can suppress Checks that have Treewalker or
+ * Checker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code files} - Define the RegExp for matching against the file name associated with

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressionXpathFilter.java

@@ -201,6 +201,9 @@
  * if no file found, then passed to the {@code ClassLoader.getResource()} method.
  * </li>
  * </ol>
+ * <p>
+ * SuppressionXpathFilter can suppress Checks that have Treewalker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code file} - Specify the location of the <em>suppressions XML document</em> file.

src/main/java/com/puppycrawl/tools/checkstyle/filters/SuppressionXpathSingleFilter.java

@@ -44,6 +44,9 @@
  * Attention: This filter only supports single suppression, and will need multiple
  * instances if users wants to suppress multiple violations.
  * </p>
+ * <p>
+ * SuppressionXpathSingleFilter can suppress Checks that have Treewalker as parent module.
+ * </p>
  * <ul>
  * <li>
  * Property {@code files} - Define a Regular Expression matched against the file

src/xdocs/config_filters.xml

@@ -31,6 +31,11 @@
           level</a> of the event.
         </p>
       </subsection>
+      <subsection name="Notes" id="SeverityMatchFilter_Notes">
+        <p>
+          SeverityMatchFilter can suppress Checks that have Treewalker or Checker as parent module.
+        </p>
+      </subsection>
       <subsection name="Properties" id="SeverityMatchFilter_Properties">
         <div class="wrapper">
           <table>
@@ -130,6 +135,9 @@
           <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Matcher.html#groupCount()">
             paren counts</a>.
         </p>
+        <p>
+          SuppressionCommentFilter can suppress Checks that have Treewalker as parent module.
+        </p>
       </subsection>
       <subsection name="Properties" id="SuppressionCommentFilter_Properties">
         <div class="wrapper">
@@ -551,6 +559,9 @@ public class UserService {
             <code>ClassLoader.getResource()</code> method.
           </li>
         </ol>
+        <p>
+          SuppressionFilter can suppress Checks that have Treewalker or Checker as parent module.
+        </p>
       </subsection>
       <subsection name="Examples" id="SuppressionFilter_Examples">
           <p>
@@ -700,6 +711,12 @@ public class UserService {
           multiple instances if users wants to suppress multiple violations.
         </p>
       </subsection>
+      <subsection name="Notes" id="SuppressionSingleFilter_Notes">
+        <p>
+          SuppressionSingleFilter can suppress Checks that have Treewalker or
+          Checker as parent module.
+        </p>
+      </subsection>
       <subsection name="Properties" id="SuppressionSingleFilter_Properties">
         <div class="wrapper">
           <table>
@@ -985,6 +1002,9 @@ public class UserService {
             <code>ClassLoader.getResource()</code> method.
           </li>
         </ol>
+        <p>
+          SuppressionXpathFilter can suppress Checks that have Treewalker as parent module.
+        </p>
       </subsection>
       <subsection name="Properties" id="SuppressionXpathFilter_Properties">
         <div class="wrapper">
@@ -1385,6 +1405,11 @@ CLASS_DEF -> CLASS_DEF [1:0]
           multiple instances if users wants to suppress multiple violations.
         </p>
       </subsection>
+      <subsection name="Notes" id="SuppressionXpathSingleFilter_Notes">
+        <p>
+          SuppressionXpathSingleFilter can suppress Checks that have Treewalker as parent module.
+        </p>
+      </subsection>
       <subsection name="Properties" id="SuppressionXpathSingleFilter_Properties">
         <div class="wrapper">
           <table>
@@ -1845,6 +1870,12 @@ public class TestClass {
               and should be written with any dotted prefix or "Check" suffix removed.
           </p>
       </subsection>
+      <subsection name="Notes" id="SuppressWarningsFilter_Notes">
+        <p>
+          SuppressWarningsFilter can suppress Checks that have Treewalker or
+          Checker as parent module.
+        </p>
+      </subsection>
       <subsection name="Examples" id="SuppressWarningsFilter_Examples">
           <p>
               To configure the check that makes tha annotations available to
@@ -1951,6 +1982,12 @@ public static void foo() {
                 SuppressWithPlainTextCommentFilter</a> or similar filter must be used.
             </p>
         </subsection>
+        <subsection name="Notes" id="SuppressWithNearbyCommentFilter_Notes">
+          <p>
+            SuppressWithNearbyCommentFilter can suppress Checks that have
+            Treewalker as parent module.
+          </p>
+        </subsection>
         <subsection name="Properties" id="SuppressWithNearbyCommentFilter_Properties">
           <div class="wrapper">
             <table>
@@ -2281,6 +2318,10 @@ public class UserService {
                   <a href="https://docs.oracle.com/en/java/javase/11/docs/api/java.base/java/util/regex/Matcher.html#groupCount()">
                   paren counts</a>.
               </p>
+              <p>
+                SuppressionWithPlainTextCommentFilter can suppress Checks that have Treewalker or
+                Checker as parent module.
+              </p>
           </subsection>
           <subsection name="Examples" id="SuppressWithPlainTextCommentFilter_Examples">
               <p>