From 98ccae9494dc1cbf674973628a5f2c57fbe155c9 Mon Sep 17 00:00:00 2001
From: Duo Zhang <zhangduo@apache.org>
Date: Wed, 12 Oct 2022 23:14:08 +0800
Subject: [PATCH] HBASE-27421 Bump spotless plugin to 2.27.2 and reimplement
 the 'Remove unhelpful javadoc stubs' rule (#4824)

Signed-off-by: Xiaolin Ha <haxiaolin@apache.org>
(cherry picked from commit 0d260f5b2279422e8ed4bea127483329f7242a42)
---
 pom.xml | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/pom.xml b/pom.xml
index 3f4447252fd..522bc6a494a 100755
--- a/pom.xml
+++ b/pom.xml
@@ -624,7 +624,7 @@
     <surefire.version>3.0.0-M6</surefire.version>
     <wagon.ssh.version>2.12</wagon.ssh.version>
     <xml.maven.version>1.0.1</xml.maven.version>
-    <spotless.version>2.24.1</spotless.version>
+    <spotless.version>2.27.2</spotless.version>
     <hbase-thirdparty.version>4.1.2</hbase-thirdparty.version>
     <maven-site.version>3.12.0</maven-site.version>
     <!-- Intraproject jar naming properties -->
@@ -2220,6 +2220,19 @@
               <exclude>**/generated/*</exclude>
               <exclude>**/package-info.java</exclude>
             </excludes>
+            <!--
+              e.g., remove the following lines:
+              "* @param paramName"
+              "* @throws ExceptionType"
+              "* @return returnType"'
+              Multiline to allow anchors on newlines
+              See https://errorprone.info/bugpattern/EmptyBlockTag
+            -->
+            <replaceRegex>
+              <name>Remove unhelpful javadoc stubs</name>
+              <searchRegex>(?m)^ *\* *@(?:param|throws|return) *\w* *\n</searchRegex>
+              <replacement/>
+            </replaceRegex>
             <!--
               e.g., rewrite
               /** @return blabla */
@@ -2229,7 +2242,8 @@
                */
               to
               /** Returns blabla */
-              See https://errorprone.info/bugpattern/EmptyBlockTag
+              See https://errorprone.info/bugpattern/MissingSummary
+              https://google.github.io/styleguide/javaguide.html#s7.2-summary-fragment
             -->
             <replaceRegex>
               <name>Purge single returns tag multi line</name>