Issue #4942: Updated javadoc grammar to make certain arguments mandatory for selected javadoc tags

3 files changed, 73 insertions, 3 deletions

diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/abstractjavadoc/InputAbstractJavadocJavadocTagsWithoutArgs.java b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/abstractjavadoc/InputAbstractJavadocJavadocTagsWithoutArgs.java
new file mode 100644
index 000000000..da491d075
--- /dev/null
+++ b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/abstractjavadoc/InputAbstractJavadocJavadocTagsWithoutArgs.java
@@ -0,0 +1,70 @@
+package com.puppycrawl.tools.checkstyle.checks.javadoc.abstractjavadoc;
+
+import java.io.Serializable;
+
+/**@author*/
+public class InputAbstractJavadocJavadocTagsWithoutArgs implements Serializable{
+    /**@serial*/
+    private static final long serialVersionUID = 7556448691029650757L;
+
+    /**@see*/
+    private static int field2;
+
+    /**@since*/
+    private static String field3;
+
+    /**@version*/
+    private static Object field4;
+
+    /**serialField*/
+    private static Object field5;
+
+    /**@exception*/
+    public static void method1() {
+
+    }
+
+    /**@throws*/
+    public static void method2() {
+
+    }
+
+    /**@return*/
+    public static int method3() {
+        return -1;
+    }
+
+    /**@param*/
+    public static void method4(int a) {
+
+    }
+
+    /**@customTag*/
+    public static void method5(int a) {
+
+    }
+
+    /**@deprecated*/
+    public static void method6(int a) {
+
+    }
+
+    /**@serialData*/
+    private void readObject(java.io.ObjectInputStream inputStream) {
+
+    }
+
+    /**
+     * {@link}
+     */
+    public void method7() {
+
+    }
+
+    /**
+     * {@linkplain }
+     */
+    public void method8() {
+
+    }
+}
diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/javadoctagcontinuationindentation/InputJavadocTagContinuationIndentation.java b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/javadoctagcontinuationindentation/InputJavadocTagContinuationIndentation.java
index a43c20756..27d5e6f37 100644
--- a/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/javadoctagcontinuationindentation/InputJavadocTagContinuationIndentation.java
+++ b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/javadoctagcontinuationindentation/InputJavadocTagContinuationIndentation.java
@@ -324,7 +324,7 @@ enum Foo1 {}
  * L.
  *
  * @author max
- * @see {@link com.puppycrawl.tools.checkstyle.AllChecksPresentOnAvailableChecksPageTest
+ * @customTag {@link com.puppycrawl.tools.checkstyle.AllChecksPresentOnAvailableChecksPageTest
  *   some description} // no warning, as this is just inline tag description
  */
 interface FooIn1 {}
diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/nonemptyatclausedescription/InputNonEmptyAtclauseDescription.java b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/nonemptyatclausedescription/InputNonEmptyAtclauseDescription.java
index ee7880239..bf3346d00 100644
--- a/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/nonemptyatclausedescription/InputNonEmptyAtclauseDescription.java
+++ b/src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/nonemptyatclausedescription/InputNonEmptyAtclauseDescription.java
@@ -75,7 +75,7 @@ class InputNonEmptyAtclauseDescription
 	 * @param a
 	 * @param b
 	 * @param c
-	 * @return
+	 * @deprecated
 	 * @throws Exception
 	 * @deprecated
 	 */
@@ -89,7 +89,7 @@ class InputNonEmptyAtclauseDescription
 	 * @param a
 	 * @param b
 	 * @param c
-	 * @return
+	 * @deprecated
 	 * @throws Exception
 	 */
 	public int foo4(String a, int b, double c) throws Exception