Issue #14631: Updated See literal to new AST format

[prathm3]

Issue: #14631

$ cat Test.java
public class Test {
    /**
     * Javadoc.
     *
     *@see org.apache.utils.Lists.Comparator#compare(Object)
     */
    public void testFunction() {}
}
prath@LAPTOP-5K4C7SC4 /cygdrive/c/Users/prath/Downloads
$ java -jar checkstyle-10.15.0-all.jar -J Test.java | sed "s/\[[0-9]\+:[0-9]\+\]//g"
COMPILATION_UNIT -> COMPILATION_UNIT
`--CLASS_DEF -> CLASS_DEF
    |--MODIFIERS -> MODIFIERS
    |   `--LITERAL_PUBLIC -> public
    |--LITERAL_CLASS -> class
    |--IDENT -> Test
    `--OBJBLOCK -> OBJBLOCK
        |--LCURLY -> {
        |--METHOD_DEF -> METHOD_DEF
        |   |--MODIFIERS -> MODIFIERS
        |   |   |--BLOCK_COMMENT_BEGIN -> /*
        |   |   |   |--COMMENT_CONTENT -> *\r\n     * Javadoc.\r\n     *\r\n     *@see org.apache.utils.Lists.Comparator#compare(Object)\r\n
        |   |   |   |   `--JAVADOC -> JAVADOC
        |   |   |   |       |--NEWLINE -> \r\n
        |   |   |   |       |--LEADING_ASTERISK ->      *
        |   |   |   |       |--TEXT ->  Javadoc.
        |   |   |   |       |--NEWLINE -> \r\n
        |   |   |   |       |--LEADING_ASTERISK ->      *
        |   |   |   |       |--NEWLINE -> \r\n
        |   |   |   |       |--LEADING_ASTERISK ->      *
        |   |   |   |       |--JAVADOC_TAG -> JAVADOC_TAG
        |   |   |   |       |   |--SEE_LITERAL -> @see
        |   |   |   |       |   |--WS ->
        |   |   |   |       |   |--REFERENCE -> REFERENCE
        |   |   |   |       |   |   |--PACKAGE_CLASS -> org.apache.utils.Lists.Comparator
        |   |   |   |       |   |   |--HASH -> #
        |   |   |   |       |   |   |--MEMBER -> compare
        |   |   |   |       |   |   `--PARAMETERS -> PARAMETERS
        |   |   |   |       |   |       |--LEFT_BRACE -> (
        |   |   |   |       |   |       |--ARGUMENT -> Object
        |   |   |   |       |   |       `--RIGHT_BRACE -> )
        |   |   |   |       |   |--NEWLINE -> \r\n
        |   |   |   |       |   `--WS ->
        |   |   |   |       `--EOF -> <EOF>
        |   |   |   `--BLOCK_COMMENT_END -> */
        |   |   `--LITERAL_PUBLIC -> public
        |   |--TYPE -> TYPE
        |   |   `--LITERAL_VOID -> void
        |   |--IDENT -> testFunction
        |   |--LPAREN -> (
        |   |--PARAMETERS -> PARAMETERS
        |   |--RPAREN -> )
        |   `--SLIST -> {
        |       `--RCURLY -> }
        `--RCURLY -> }

prath@LAPTOP-5K4C7SC4 /cygdrive/c/Users/prath/Downloads

[MANISH-K-07]

Item:

[MANISH-K-07]

Please squash and rebase to single commit to make CI green

[romani]

ok to merge if CI pass

[MANISH-K-07]

ok to merge if CI pass

@romani , Just pointing out, there are still 2 commits in this PR..

[romani]

thanks a lot for hint.

@prathm3 , please squash commits in one commit.

[romani]

see above

[MANISH-K-07]

@prathm3 , looks like you dropped the latest commit instead of squash.
The suggested changes are reverted now. Please see to it....

https://checkstyle.org/beginning_development.html contains good documentation on rebase steps

[prathm3]

@MANISH-K-07 Thank you for your help. This is my first squashed commit. I have squashed changes. Please let me know any changes required.

[prathm3]

@prathm3 , please squash commits in one commit.

@romani, I have made changes, let me know any changes needed.

[MANISH-K-07]

The 3 lines above are spaced one extra I think.
@prathm3 , could you please recheck with AST from cli?

[prathm3]

Done