Issue checkstyle#16005: html-element to be ended with dot in javadoc's …

…@see

src/main/resources/com/puppycrawl/tools/checkstyle/grammar/javadoc/JavadocParser.g4

@@ -1151,7 +1151,10 @@ javadocTag: AUTHOR_LITERAL (WS | NEWLINE)* ((WS | NEWLINE) description)?
       | RETURN_LITERAL (WS | NEWLINE)* ((WS | NEWLINE) description)?
 
       | SEE_LITERAL (WS | NEWLINE | {!isNextJavadocTag()}? LEADING_ASTERISK)+
-          (reference | STRING | htmlElement) (WS | NEWLINE)* ((WS | NEWLINE) description)?
+          (
+            htmlElement (WS | NEWLINE)* description?
+            | (reference | STRING)  (WS | NEWLINE)* ((WS | NEWLINE) description)?
+          )
 
       | SERIAL_LITERAL (WS | NEWLINE)*
           ((WS | NEWLINE) description | LITERAL_INCLUDE | LITERAL_EXCLUDE)? (WS | NEWLINE)*

src/test/java/com/puppycrawl/tools/checkstyle/checks/javadoc/NonEmptyAtclauseDescriptionCheckTest.java

@@ -129,4 +129,11 @@ public void testDecoderOnMalformedInput() throws Exception {
         verify(checkerConfig,
                 getPath("InputNonEmptyAtclauseDescriptionDifferentCharset.java"), expected);
     }
+
+    @Test
+    public void testExample3() throws Exception {
+        final String[] expected = CommonUtil.EMPTY_STRING_ARRAY;
+        verifyWithInlineConfigParser(
+                getPath("InputNonEmptyAtclauseDescriptionThree.java"), expected);
+    }
 }

src/test/resources/com/puppycrawl/tools/checkstyle/checks/javadoc/nonemptyatclausedescription/InputNonEmptyAtclauseDescriptionThree.java

@@ -0,0 +1,46 @@
+/*xml
+<module name="Checker">
+  <module name="TreeWalker">
+    <module name="NonEmptyAtclauseDescription">
+      <property name="javadocTokens" value="PARAM_LITERAL,THROWS_LITERAL"/>
+    </module>
+  </module>
+</module>
+*/
+package com.puppycrawl.tools.checkstyle.checks.javadoc.nonemptyatclausedescription;
+
+// xdoc section -- start
+class InputNonEmptyAtclauseDescriptionThree {
+
+  /**
+   * Some summary.
+   *
+   * @param j some param
+   * @see <a href="www.checkstyle.org/">website</a>some description
+   */
+  public int endwithDot(int j){
+    return j+1;
+  }
+
+  /**
+   * Some summary.
+   *
+   * @param j some param
+   * @see <a href="https://docs.oracle.com/">
+   * keyPairGenerator Algorithms</a>there is some description.
+   */
+  public int testMethod(int j){
+    return j-1;
+  }
+
+  /**
+   * Some summary.
+   *
+   * @param j some param
+   * @see description
+   */
+  public int testMethod2(int j){
+    return j-1;
+  }
+}
+// xdoc section -- end