diff --git a/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocTokenTypes.java b/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocTokenTypes.java index a58b38cdfe96..c521ec788d1e 100644 --- a/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocTokenTypes.java +++ b/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocTokenTypes.java @@ -313,7 +313,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] @@ -614,7 +614,7 @@ public final class JavadocTokenTypes { * |--LINK_LITERAL[1x1] : [@link] * |--WS[1x6] : [ ] * |--REFERENCE[1x7] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[1x7] : [org.apache.utils] + * |--PACKAGE_CLASS[1x7] : [org.apache.utils] * |--DOT[1x23] : [.] * |--CLASS[1x24] : [Lists] * |--DOT[1x29] : [.] @@ -680,7 +680,7 @@ public final class JavadocTokenTypes { * |--LINKPLAIN_LITERAL[1x1] : [@linkplain] * |--WS[1x11] : [ ] * |--REFERENCE[1x12] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[1x12] : [org.apache.utils] + * |--PACKAGE_CLASS[1x12] : [org.apache.utils] * |--DOT[1x28] : [.] * |--CLASS[1x29] : [Lists] * |--DOT[1x34] : [.] @@ -781,8 +781,7 @@ public final class JavadocTokenTypes { public static final int REFERENCE = JavadocParser.RULE_reference + RULE_TYPES_OFFSET; /** - * Package definition in {@link #REFERENCE}. - * Package definition is lowercase part of REFERENCE and before a hash character (#). + * Package_Class definition in {@link #REFERENCE}. * *

* Example: @@ -793,7 +792,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] @@ -807,7 +806,7 @@ public final class JavadocTokenTypes { * } * */ - public static final int PACKAGE = JavadocParser.PACKAGE; + public static final int PACKAGE_CLASS = JavadocParser.PACKAGE_CLASS; /** * Class definition in {@link #REFERENCE}. @@ -823,7 +822,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] @@ -841,7 +840,7 @@ public final class JavadocTokenTypes { /** * Dot separator in {@link #REFERENCE}. - * Dot separator is used between {@link #PACKAGE} and {@link #CLASS}; between {@link #CLASS} + * Dot separator is used between {@link #PACKAGE_CLASS} and {@link #CLASS}; between {@link #CLASS} * and {@link #CLASS} * *

@@ -853,7 +852,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] @@ -882,7 +881,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] @@ -911,7 +910,7 @@ public final class JavadocTokenTypes { * |--SEE_LITERAL[3x0] : [@see] * |--WS[3x4] : [ ] * |--REFERENCE[3x5] : [org.apache.utils.Lists.Comparator#compare(Object)] - * |--PACKAGE[3x5] : [org.apache.utils] + * |--PACKAGE_CLASS[3x5] : [org.apache.utils] * |--DOT[3x21] : [.] * |--CLASS[3x22] : [Lists] * |--DOT[3x27] : [.] diff --git a/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocLexer.g4 b/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocLexer.g4 index f015ae5966e2..3c3479374827 100644 --- a/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocLexer.g4 +++ b/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocLexer.g4 @@ -120,10 +120,10 @@ Newline5: NEWLINE Leading_asterisk3: LEADING_ASTERISK -> type(LEADING_ASTERISK); XmlTagOpen1: '<' -> type(OPEN), pushMode(xmlTagDefinition); STRING: '"' .*? '"' {referenceCatched = false;} -> mode(DEFAULT_MODE); -PACKAGE: [a-z_$] ([a-z0-9_$] | '.')+ [a-z0-9_$] {referenceCatched = true;}; +PACKAGE_CLASS: [a-zA-Z_$] ('.'? [a-zA-Z0-9_$]+)* {referenceCatched = true;}; DOT: '.'; HASH: '#' {referenceCatched = true;} -> mode(classMemeber); -CLASS: [A-Z] [a-zA-Z0-9_$]* {referenceCatched = true;}; +CLASS: [a-zA-Z_$] [a-zA-Z0-9_$]* {referenceCatched = true;}; End20: JAVADOC_INLINE_TAG_END { insideJavadocInlineTag--; @@ -252,7 +252,7 @@ Char8: . mode value; Space6: WS -> type(WS); Newline4: NEWLINE -> type(NEWLINE); -Package2: PACKAGE -> type(PACKAGE); +Package_Class2: PACKAGE_CLASS -> type(PACKAGE_CLASS); Dot2: DOT -> type(DOT); Class2: CLASS -> type(CLASS); Hash2: HASH -> type(HASH), mode(classMemeber); diff --git a/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParser.g4 b/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParser.g4 index aceab56f1459..cf8b1428c308 100644 --- a/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParser.g4 +++ b/src/main/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParser.g4 @@ -861,8 +861,7 @@ description: ( reference: ( - PACKAGE (DOT | CLASS)* HASH? MEMBER? parameters? - | (DOT | CLASS)+ HASH? MEMBER? parameters? + PACKAGE_CLASS HASH? MEMBER? parameters? | HASH? MEMBER parameters? ) ; diff --git a/src/test/java/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParseTreeTest.java b/src/test/java/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParseTreeTest.java index b194e048bced..a2438bcb6e4b 100644 --- a/src/test/java/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParseTreeTest.java +++ b/src/test/java/com/puppycrawl/tools/checkstyle/grammars/javadoc/JavadocParseTreeTest.java @@ -250,4 +250,10 @@ public void testJavadocWithCrAsNewline() throws Exception { verifyJavadocTree(getPath("expectedJavadocWithCrAsNewlineAst.txt"), getPath("InputJavadocWithCrAsNewline.javadoc")); } + + @Test + public void testUppercaseInPackageName() throws Exception { + verifyJavadocTree(getDocPath("expectedUppercaseInPackageNameAst.txt"), + getDocPath("InputUppercaseInPackageName.javadoc")); + } } diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedInputJavadocComment.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedInputJavadocComment.txt index 5b4d7a252009..5d3211be1faf 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedInputJavadocComment.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedInputJavadocComment.txt @@ -24,5 +24,5 @@ JAVADOC -> JAVADOC [0:0] | |--SEE_LITERAL -> @see [3:0] | |--WS -> [3:4] | `--REFERENCE -> REFERENCE [3:5] -| `--PACKAGE -> never [3:5] +| `--PACKAGE_CLASS -> never [3:5] `--EOF -> [3:10] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedNoUnnecessaryTextInJavadocAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedNoUnnecessaryTextInJavadocAst.txt index c9205bbc9903..58eb4ab77b67 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedNoUnnecessaryTextInJavadocAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/astprinter/expectedNoUnnecessaryTextInJavadocAst.txt @@ -31,5 +31,5 @@ JAVADOC -> JAVADOC [0:0] | |--SEE_LITERAL -> @see [3:2] | |--WS -> [3:6] | `--REFERENCE -> REFERENCE [3:7] -| `--PACKAGE -> something [3:7] +| `--PACKAGE_CLASS -> something [3:7] `--EOF -> [3:16] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/InputUppercaseInPackageName.javadoc b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/InputUppercaseInPackageName.javadoc new file mode 100644 index 000000000000..8be69148efac --- /dev/null +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/InputUppercaseInPackageName.javadoc @@ -0,0 +1,22 @@ +* @see #fn +* @see #FN +* @see #C(Type) +* @see #CN(Type id) +* @see #mN(Type id, Type, Type id) +* @see CN#fieldName +* @see CN#fn +* @see name#FN +* @see CN#C(Type) +* @see CN#CN(Type id) +* @see CN#mN(Type id, Type, Type id) +* @see lowercase.UPPERCASE.CamelCase.packageName.ClassName#fieldName +* @see lowercase.UPPERCASE.CamelCase.packageName.ClassName#fn +* @see lowercase.UPPERCASE.CamelCase.packageName.ClassName#FN +* @see lowercase.UPPERCASE.CamelCase.packageName.ClassName#C(Type) +* @see lowercase.UPPERCASE.CamelCase.packageName.ClassName#CN(Type id) +* @see pn.CN#mN(Type id, Type, Type id) +* @see pn.CN#FN +* @see pn.CN#m +* @see lowercase.UPPERCASE.CamelCase.packageName +* @see pn.p +* @see pn \ No newline at end of file diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllJavadocInlineTagsAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllJavadocInlineTagsAst.txt index ea5c5d09e047..e38737ba739a 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllJavadocInlineTagsAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllJavadocInlineTagsAst.txt @@ -28,7 +28,7 @@ JAVADOC -> JAVADOC [0:0] | |--LINK_LITERAL -> @link [0:64] | |--WS -> [0:69] | |--REFERENCE -> REFERENCE [0:70] -| | `--CLASS -> A [0:70] +| | `--PACKAGE_CLASS -> A [0:70] | |--DESCRIPTION -> DESCRIPTION [0:71] | | `--TEXT -> A class [0:71] | `--JAVADOC_INLINE_TAG_END -> } [0:79] @@ -38,7 +38,7 @@ JAVADOC -> JAVADOC [0:0] | |--LINKPLAIN_LITERAL -> @linkplain [0:82] | |--WS -> [0:92] | |--REFERENCE -> REFERENCE [0:93] -| | `--CLASS -> A [0:93] +| | `--PACKAGE_CLASS -> A [0:93] | |--DESCRIPTION -> DESCRIPTION [0:94] | | `--TEXT -> another link [0:94] | `--JAVADOC_INLINE_TAG_END -> } [0:107] @@ -48,9 +48,7 @@ JAVADOC -> JAVADOC [0:0] | |--VALUE_LITERAL -> @value [0:110] | |--WS -> [0:116] | |--REFERENCE -> REFERENCE [0:117] -| | |--PACKAGE -> lang [0:117] -| | |--DOT -> . [0:121] -| | |--CLASS -> Integer [0:122] +| | |--PACKAGE_CLASS -> lang.Integer [0:117] | | |--HASH -> # [0:129] | | `--MEMBER -> MAX_VALUE [0:130] | `--JAVADOC_INLINE_TAG_END -> } [0:139] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllStandardJavadocTagsAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllStandardJavadocTagsAst.txt index 5d04ec983706..8684dfedcae2 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllStandardJavadocTagsAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAllStandardJavadocTagsAst.txt @@ -1,17 +1,17 @@ JAVADOC -> JAVADOC [0:0] -|--NEWLINE -> \r\n [0:0] +|--NEWLINE -> \n [0:0] |--JAVADOC_TAG -> JAVADOC_TAG [1:0] | |--AUTHOR_LITERAL -> @author [1:0] | |--WS -> [1:7] | `--DESCRIPTION -> DESCRIPTION [1:8] | |--TEXT -> John Locke [1:8] -| `--NEWLINE -> \r\n [1:18] +| `--NEWLINE -> \n [1:18] |--JAVADOC_TAG -> JAVADOC_TAG [2:0] | |--AUTHOR_LITERAL -> @author [2:0] | |--WS -> [2:7] | `--DESCRIPTION -> DESCRIPTION [2:8] | |--TEXT -> Man in black, Sub Zero [2:8] -| `--NEWLINE -> \r\n [2:30] +| `--NEWLINE -> \n [2:30] |--JAVADOC_TAG -> JAVADOC_TAG [3:0] | |--AUTHOR_LITERAL -> @author [3:0] | |--WS -> [3:7] @@ -33,15 +33,15 @@ JAVADOC -> JAVADOC [0:0] | | |--SLASH -> / [3:60] | | |--HTML_TAG_NAME -> a [3:61] | | `--CLOSE -> > [3:62] -| `--NEWLINE -> \r\n [3:63] +| `--NEWLINE -> \n [3:63] |--JAVADOC_TAG -> JAVADOC_TAG [4:0] | |--DEPRECATED_LITERAL -> @deprecated [4:0] | |--WS -> [4:11] | `--DESCRIPTION -> DESCRIPTION [4:12] | |--TEXT -> This method is deprecated [4:12] -| |--NEWLINE -> \r\n [4:37] +| |--NEWLINE -> \n [4:37] | |--TEXT -> because we created new one. [5:0] -| `--NEWLINE -> \r\n [5:27] +| `--NEWLINE -> \n [5:27] |--JAVADOC_TAG -> JAVADOC_TAG [6:0] | |--EXCEPTION_LITERAL -> @exception [6:0] | |--WS -> [6:10] @@ -49,7 +49,7 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [6:22] | `--DESCRIPTION -> DESCRIPTION [6:23] | |--TEXT -> throws exception if connection refused. [6:23] -| `--NEWLINE -> \r\n [6:62] +| `--NEWLINE -> \n [6:62] |--JAVADOC_TAG -> JAVADOC_TAG [7:0] | |--PARAM_LITERAL -> @param [7:0] | |--WS -> [7:6] @@ -57,7 +57,7 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [7:10] | `--DESCRIPTION -> DESCRIPTION [7:11] | |--TEXT -> String argument [7:11] -| `--NEWLINE -> \r\n [7:26] +| `--NEWLINE -> \n [7:26] |--JAVADOC_TAG -> JAVADOC_TAG [8:0] | |--PARAM_LITERAL -> @param [8:0] | |--WS -> [8:6] @@ -65,7 +65,7 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [8:10] | `--DESCRIPTION -> DESCRIPTION [8:11] | |--TEXT -> it is generic [8:11] -| `--NEWLINE -> \r\n [8:24] +| `--NEWLINE -> \n [8:24] |--JAVADOC_TAG -> JAVADOC_TAG [9:0] | |--PARAM_LITERAL -> @param [9:0] | |--WS -> [9:6] @@ -73,30 +73,30 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [9:11] | `--DESCRIPTION -> DESCRIPTION [9:12] | |--TEXT -> I can describe 'type' [9:12] -| |--NEWLINE -> \r\n [9:33] +| |--NEWLINE -> \n [9:33] | |--TEXT -> on several lines. [10:0] -| |--NEWLINE -> \r\n [10:17] +| |--NEWLINE -> \n [10:17] | |--TEXT -> One more line of description. [11:0] -| `--NEWLINE -> \r\n [11:29] +| `--NEWLINE -> \n [11:29] |--JAVADOC_TAG -> JAVADOC_TAG [12:0] | |--RETURN_LITERAL -> @return [12:0] | |--WS -> [12:7] | `--DESCRIPTION -> DESCRIPTION [12:8] | |--TEXT -> something [12:8] -| `--NEWLINE -> \r\n [12:17] +| `--NEWLINE -> \n [12:17] |--JAVADOC_TAG -> JAVADOC_TAG [13:0] | |--RETURN_LITERAL -> @return [13:0] | |--WS -> [13:7] | `--DESCRIPTION -> DESCRIPTION [13:8] | |--TEXT -> a value of element [13:8] -| |--NEWLINE -> \r\n [13:26] +| |--NEWLINE -> \n [13:26] | |--TEXT -> that is passed as argument. [14:0] -| `--NEWLINE -> \r\n [14:27] +| `--NEWLINE -> \n [14:27] |--JAVADOC_TAG -> JAVADOC_TAG [15:0] | |--SEE_LITERAL -> @see [15:0] | |--WS -> [15:4] | |--STRING -> "A book of that famous man" [15:5] -| `--NEWLINE -> \r\n [15:32] +| `--NEWLINE -> \n [15:32] |--JAVADOC_TAG -> JAVADOC_TAG [16:0] | |--SEE_LITERAL -> @see [16:0] | |--WS -> [16:4] @@ -117,7 +117,7 @@ JAVADOC -> JAVADOC [0:0] | | |--SLASH -> / [16:41] | | |--HTML_TAG_NAME -> a [16:42] | | `--CLOSE -> > [16:43] -| `--NEWLINE -> \r\n [16:44] +| `--NEWLINE -> \n [16:44] |--JAVADOC_TAG -> JAVADOC_TAG [17:0] | |--SEE_LITERAL -> @see [17:0] | |--WS -> [17:4] @@ -132,103 +132,87 @@ JAVADOC -> JAVADOC [0:0] | | | | |--EQUALS -> = [17:12] | | | | `--ATTR_VALUE -> "http://google.com" [17:13] | | | `--CLOSE -> > [17:33] -| | |--NEWLINE -> \r\n [17:34] +| | |--NEWLINE -> \n [17:34] | | |--TEXT -> Google [18:0] | | `--HTML_ELEMENT_CLOSE -> HTML_ELEMENT_CLOSE [18:6] | | |--OPEN -> < [18:6] | | |--SLASH -> / [18:7] | | |--HTML_TAG_NAME -> a [18:8] | | `--CLOSE -> > [18:9] -| `--NEWLINE -> \r\n [18:10] +| `--NEWLINE -> \n [18:10] |--JAVADOC_TAG -> JAVADOC_TAG [19:0] | |--SEE_LITERAL -> @see [19:0] | |--WS -> [19:4] | |--REFERENCE -> REFERENCE [19:5] -| | |--PACKAGE -> java.lang [19:5] -| | |--DOT -> . [19:14] -| | |--CLASS -> Integer [19:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [19:5] | | |--HASH -> # [19:22] | | `--MEMBER -> valueOf [19:23] -| `--NEWLINE -> \r\n [19:30] +| `--NEWLINE -> \n [19:30] |--JAVADOC_TAG -> JAVADOC_TAG [20:0] | |--SEE_LITERAL -> @see [20:0] | |--WS -> [20:4] | |--REFERENCE -> REFERENCE [20:5] -| | |--PACKAGE -> java.lang [20:5] -| | |--DOT -> . [20:14] -| | |--CLASS -> Integer [20:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [20:5] | | |--HASH -> # [20:22] | | `--MEMBER -> Integer [20:23] -| `--NEWLINE -> \r\n [20:30] +| `--NEWLINE -> \n [20:30] |--JAVADOC_TAG -> JAVADOC_TAG [21:0] | |--SEE_LITERAL -> @see [21:0] | |--WS -> [21:4] | |--REFERENCE -> REFERENCE [21:5] -| | |--PACKAGE -> java.lang [21:5] -| | |--DOT -> . [21:14] -| | |--CLASS -> Integer [21:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [21:5] | | |--HASH -> # [21:22] | | `--MEMBER -> MAX_VALUE [21:23] -| `--NEWLINE -> \r\n [21:32] +| `--NEWLINE -> \n [21:32] |--JAVADOC_TAG -> JAVADOC_TAG [22:0] | |--SEE_LITERAL -> @see [22:0] | |--WS -> [22:4] | |--REFERENCE -> REFERENCE [22:5] -| | |--PACKAGE -> java.lang [22:5] -| | |--DOT -> . [22:14] -| | |--CLASS -> Integer [22:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [22:5] | | |--HASH -> # [22:22] | | `--MEMBER -> valueOf [22:23] | |--WS -> [22:30] | `--DESCRIPTION -> DESCRIPTION [22:31] | |--TEXT -> valueOf method [22:31] -| `--NEWLINE -> \r\n [22:45] +| `--NEWLINE -> \n [22:45] |--JAVADOC_TAG -> JAVADOC_TAG [23:0] | |--SEE_LITERAL -> @see [23:0] | |--WS -> [23:4] | |--REFERENCE -> REFERENCE [23:5] -| | |--PACKAGE -> java.lang [23:5] -| | |--DOT -> . [23:14] -| | |--CLASS -> Integer [23:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [23:5] | | |--HASH -> # [23:22] | | `--MEMBER -> Integer [23:23] | |--WS -> [23:30] | `--DESCRIPTION -> DESCRIPTION [23:31] | |--TEXT -> Integer [23:31] -| `--NEWLINE -> \r\n [23:38] +| `--NEWLINE -> \n [23:38] |--JAVADOC_TAG -> JAVADOC_TAG [24:0] | |--SEE_LITERAL -> @see [24:0] | |--WS -> [24:4] | |--REFERENCE -> REFERENCE [24:5] -| | |--PACKAGE -> java.lang [24:5] -| | |--DOT -> . [24:14] -| | |--CLASS -> Integer [24:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [24:5] | | |--HASH -> # [24:22] | | `--MEMBER -> MAX_VALUE [24:23] | |--WS -> [24:32] | `--DESCRIPTION -> DESCRIPTION [24:33] | |--TEXT -> maxValue [24:33] -| `--NEWLINE -> \r\n [24:41] +| `--NEWLINE -> \n [24:41] |--JAVADOC_TAG -> JAVADOC_TAG [25:0] | |--SEE_LITERAL -> @see [25:0] | |--WS -> [25:4] | |--REFERENCE -> REFERENCE [25:5] -| | |--PACKAGE -> java.lang [25:5] -| | |--DOT -> . [25:14] -| | |--CLASS -> Integer [25:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [25:5] | | |--HASH -> # [25:22] | | `--MEMBER -> intValue [25:23] | |--WS -> [25:31] | `--DESCRIPTION -> DESCRIPTION [25:32] | |--TEXT -> method [25:32] -| `--NEWLINE -> \r\n [25:38] +| `--NEWLINE -> \n [25:38] |--JAVADOC_TAG -> JAVADOC_TAG [26:0] | |--SEE_LITERAL -> @see [26:0] | |--WS -> [26:4] | |--REFERENCE -> REFERENCE [26:5] -| | |--PACKAGE -> java.lang [26:5] -| | |--DOT -> . [26:14] -| | |--CLASS -> Integer [26:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [26:5] | | |--HASH -> # [26:22] | | |--MEMBER -> intValue [26:23] | | `--PARAMETERS -> PARAMETERS [26:31] @@ -237,27 +221,23 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [26:33] | `--DESCRIPTION -> DESCRIPTION [26:34] | |--TEXT -> method [26:34] -| `--NEWLINE -> \r\n [26:40] +| `--NEWLINE -> \n [26:40] |--JAVADOC_TAG -> JAVADOC_TAG [27:0] | |--SEE_LITERAL -> @see [27:0] | |--WS -> [27:4] | |--REFERENCE -> REFERENCE [27:5] -| | |--PACKAGE -> java.lang [27:5] -| | |--DOT -> . [27:14] -| | |--CLASS -> Void [27:15] +| | |--PACKAGE_CLASS -> java.lang.Void [27:5] | | |--HASH -> # [27:19] | | `--MEMBER -> Void [27:20] | |--WS -> [27:24] | `--DESCRIPTION -> DESCRIPTION [27:25] | |--TEXT -> constructor [27:25] -| `--NEWLINE -> \r\n [27:36] +| `--NEWLINE -> \n [27:36] |--JAVADOC_TAG -> JAVADOC_TAG [28:0] | |--SEE_LITERAL -> @see [28:0] | |--WS -> [28:4] | |--REFERENCE -> REFERENCE [28:5] -| | |--PACKAGE -> java.lang [28:5] -| | |--DOT -> . [28:14] -| | |--CLASS -> Void [28:15] +| | |--PACKAGE_CLASS -> java.lang.Void [28:5] | | |--HASH -> # [28:19] | | |--MEMBER -> Void [28:20] | | `--PARAMETERS -> PARAMETERS [28:24] @@ -266,14 +246,12 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [28:26] | `--DESCRIPTION -> DESCRIPTION [28:27] | |--TEXT -> constructor [28:27] -| `--NEWLINE -> \r\n [28:38] +| `--NEWLINE -> \n [28:38] |--JAVADOC_TAG -> JAVADOC_TAG [29:0] | |--SEE_LITERAL -> @see [29:0] | |--WS -> [29:4] | |--REFERENCE -> REFERENCE [29:5] -| | |--PACKAGE -> java.lang [29:5] -| | |--DOT -> . [29:14] -| | |--CLASS -> Integer [29:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [29:5] | | |--HASH -> # [29:22] | | |--MEMBER -> valueOf [29:23] | | `--PARAMETERS -> PARAMETERS [29:30] @@ -283,14 +261,12 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [29:38] | `--DESCRIPTION -> DESCRIPTION [29:39] | |--TEXT -> method [29:39] -| `--NEWLINE -> \r\n [29:45] +| `--NEWLINE -> \n [29:45] |--JAVADOC_TAG -> JAVADOC_TAG [30:0] | |--SEE_LITERAL -> @see [30:0] | |--WS -> [30:4] | |--REFERENCE -> REFERENCE [30:5] -| | |--PACKAGE -> java.lang [30:5] -| | |--DOT -> . [30:14] -| | |--CLASS -> Integer [30:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [30:5] | | |--HASH -> # [30:22] | | |--MEMBER -> toString [30:23] | | `--PARAMETERS -> PARAMETERS [30:31] @@ -302,14 +278,12 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [30:40] | `--DESCRIPTION -> DESCRIPTION [30:41] | |--TEXT -> method [30:41] -| `--NEWLINE -> \r\n [30:47] +| `--NEWLINE -> \n [30:47] |--JAVADOC_TAG -> JAVADOC_TAG [31:0] | |--SEE_LITERAL -> @see [31:0] | |--WS -> [31:4] | |--REFERENCE -> REFERENCE [31:5] -| | |--PACKAGE -> java.lang [31:5] -| | |--DOT -> . [31:14] -| | |--CLASS -> Integer [31:15] +| | |--PACKAGE_CLASS -> java.lang.Integer [31:5] | | |--HASH -> # [31:22] | | |--MEMBER -> toString [31:23] | | `--PARAMETERS -> PARAMETERS [31:31] @@ -322,14 +296,14 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [31:41] | `--DESCRIPTION -> DESCRIPTION [31:42] | |--TEXT -> method [31:42] -| `--NEWLINE -> \r\n [31:48] +| `--NEWLINE -> \n [31:48] |--JAVADOC_TAG -> JAVADOC_TAG [32:0] | |--SEE_LITERAL -> @see [32:0] | |--WS -> [32:4] | |--REFERENCE -> REFERENCE [32:5] | | |--HASH -> # [32:5] | | `--MEMBER -> field [32:6] -| `--NEWLINE -> \r\n [32:11] +| `--NEWLINE -> \n [32:11] |--JAVADOC_TAG -> JAVADOC_TAG [33:0] | |--SEE_LITERAL -> @see [33:0] | |--WS -> [33:4] @@ -343,7 +317,7 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [33:18] | | |--ARGUMENT -> Type [33:19] | | `--RIGHT_BRACE -> ) [33:23] -| `--NEWLINE -> \r\n [33:24] +| `--NEWLINE -> \n [33:24] |--JAVADOC_TAG -> JAVADOC_TAG [34:0] | |--SEE_LITERAL -> @see [34:0] | |--WS -> [34:4] @@ -361,7 +335,7 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [34:31] | | |--ARGUMENT -> argname [34:32] | | `--RIGHT_BRACE -> ) [34:39] -| `--NEWLINE -> \r\n [34:40] +| `--NEWLINE -> \n [34:40] |--JAVADOC_TAG -> JAVADOC_TAG [35:0] | |--SEE_LITERAL -> @see [35:0] | |--WS -> [35:4] @@ -375,7 +349,7 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [35:23] | | |--ARGUMENT -> Type [35:24] | | `--RIGHT_BRACE -> ) [35:28] -| `--NEWLINE -> \r\n [35:29] +| `--NEWLINE -> \n [35:29] |--JAVADOC_TAG -> JAVADOC_TAG [36:0] | |--SEE_LITERAL -> @see [36:0] | |--WS -> [36:4] @@ -393,20 +367,20 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [36:36] | | |--ARGUMENT -> argname [36:37] | | `--RIGHT_BRACE -> ) [36:44] -| `--NEWLINE -> \r\n [36:45] +| `--NEWLINE -> \n [36:45] |--JAVADOC_TAG -> JAVADOC_TAG [37:0] | |--SEE_LITERAL -> @see [37:0] | |--WS -> [37:4] | |--REFERENCE -> REFERENCE [37:5] -| | |--CLASS -> Class [37:5] +| | |--PACKAGE_CLASS -> Class [37:5] | | |--HASH -> # [37:10] | | `--MEMBER -> field [37:11] -| `--NEWLINE -> \r\n [37:16] +| `--NEWLINE -> \n [37:16] |--JAVADOC_TAG -> JAVADOC_TAG [38:0] | |--SEE_LITERAL -> @see [38:0] | |--WS -> [38:4] | |--REFERENCE -> REFERENCE [38:5] -| | |--CLASS -> Class [38:5] +| | |--PACKAGE_CLASS -> Class [38:5] | | |--HASH -> # [38:10] | | |--MEMBER -> method [38:11] | | `--PARAMETERS -> PARAMETERS [38:17] @@ -419,12 +393,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [38:29] | | |--ARGUMENT -> Type [38:30] | | `--RIGHT_BRACE -> ) [38:34] -| `--NEWLINE -> \r\n [38:35] +| `--NEWLINE -> \n [38:35] |--JAVADOC_TAG -> JAVADOC_TAG [39:0] | |--SEE_LITERAL -> @see [39:0] | |--WS -> [39:4] | |--REFERENCE -> REFERENCE [39:5] -| | |--CLASS -> Class [39:5] +| | |--PACKAGE_CLASS -> Class [39:5] | | |--HASH -> # [39:10] | | |--MEMBER -> method [39:11] | | `--PARAMETERS -> PARAMETERS [39:17] @@ -438,12 +412,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [39:36] | | |--ARGUMENT -> argname [39:37] | | `--RIGHT_BRACE -> ) [39:44] -| `--NEWLINE -> \r\n [39:45] +| `--NEWLINE -> \n [39:45] |--JAVADOC_TAG -> JAVADOC_TAG [40:0] | |--SEE_LITERAL -> @see [40:0] | |--WS -> [40:4] | |--REFERENCE -> REFERENCE [40:5] -| | |--CLASS -> Class [40:5] +| | |--PACKAGE_CLASS -> Class [40:5] | | |--HASH -> # [40:10] | | |--MEMBER -> constructor [40:11] | | `--PARAMETERS -> PARAMETERS [40:22] @@ -453,12 +427,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [40:28] | | |--ARGUMENT -> Type [40:29] | | `--RIGHT_BRACE -> ) [40:33] -| `--NEWLINE -> \r\n [40:34] +| `--NEWLINE -> \n [40:34] |--JAVADOC_TAG -> JAVADOC_TAG [41:0] | |--SEE_LITERAL -> @see [41:0] | |--WS -> [41:4] | |--REFERENCE -> REFERENCE [41:5] -| | |--CLASS -> Class [41:5] +| | |--PACKAGE_CLASS -> Class [41:5] | | |--HASH -> # [41:10] | | |--MEMBER -> constructor [41:11] | | `--PARAMETERS -> PARAMETERS [41:22] @@ -472,38 +446,32 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [41:41] | | |--ARGUMENT -> argname [41:42] | | `--RIGHT_BRACE -> ) [41:49] -| `--NEWLINE -> \r\n [41:50] +| `--NEWLINE -> \n [41:50] |--JAVADOC_TAG -> JAVADOC_TAG [42:0] | |--SEE_LITERAL -> @see [42:0] | |--WS -> [42:4] | |--REFERENCE -> REFERENCE [42:5] -| | |--CLASS -> Class [42:5] -| | |--DOT -> . [42:10] -| | `--CLASS -> NestedClass [42:11] -| `--NEWLINE -> \r\n [42:22] +| | `--PACKAGE_CLASS -> Class.NestedClass [42:5] +| `--NEWLINE -> \n [42:22] |--JAVADOC_TAG -> JAVADOC_TAG [43:0] | |--SEE_LITERAL -> @see [43:0] | |--WS -> [43:4] | |--REFERENCE -> REFERENCE [43:5] -| | `--CLASS -> Class [43:5] -| `--NEWLINE -> \r\n [43:10] +| | `--PACKAGE_CLASS -> Class [43:5] +| `--NEWLINE -> \n [43:10] |--JAVADOC_TAG -> JAVADOC_TAG [44:0] | |--SEE_LITERAL -> @see [44:0] | |--WS -> [44:4] | |--REFERENCE -> REFERENCE [44:5] -| | |--PACKAGE -> com.github.checkstyle [44:5] -| | |--DOT -> . [44:26] -| | |--CLASS -> Class [44:27] +| | |--PACKAGE_CLASS -> com.github.checkstyle.Class [44:5] | | |--HASH -> # [44:32] | | `--MEMBER -> field [44:33] -| `--NEWLINE -> \r\n [44:38] +| `--NEWLINE -> \n [44:38] |--JAVADOC_TAG -> JAVADOC_TAG [45:0] | |--SEE_LITERAL -> @see [45:0] | |--WS -> [45:4] | |--REFERENCE -> REFERENCE [45:5] -| | |--PACKAGE -> com.github.checkstyle [45:5] -| | |--DOT -> . [45:26] -| | |--CLASS -> Class [45:27] +| | |--PACKAGE_CLASS -> com.github.checkstyle.Class [45:5] | | |--HASH -> # [45:32] | | |--MEMBER -> method [45:33] | | `--PARAMETERS -> PARAMETERS [45:39] @@ -513,14 +481,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [45:45] | | |--ARGUMENT -> Type [45:46] | | `--RIGHT_BRACE -> ) [45:50] -| `--NEWLINE -> \r\n [45:51] +| `--NEWLINE -> \n [45:51] |--JAVADOC_TAG -> JAVADOC_TAG [46:0] | |--SEE_LITERAL -> @see [46:0] | |--WS -> [46:4] | |--REFERENCE -> REFERENCE [46:5] -| | |--PACKAGE -> com.github.checkstyle [46:5] -| | |--DOT -> . [46:26] -| | |--CLASS -> Class [46:27] +| | |--PACKAGE_CLASS -> com.github.checkstyle.Class [46:5] | | |--HASH -> # [46:32] | | |--MEMBER -> method [46:33] | | `--PARAMETERS -> PARAMETERS [46:39] @@ -534,14 +500,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [46:58] | | |--ARGUMENT -> argname [46:59] | | `--RIGHT_BRACE -> ) [46:66] -| `--NEWLINE -> \r\n [46:67] +| `--NEWLINE -> \n [46:67] |--JAVADOC_TAG -> JAVADOC_TAG [47:0] | |--SEE_LITERAL -> @see [47:0] | |--WS -> [47:4] | |--REFERENCE -> REFERENCE [47:5] -| | |--PACKAGE -> com.github.checkstyle [47:5] -| | |--DOT -> . [47:26] -| | |--CLASS -> Class [47:27] +| | |--PACKAGE_CLASS -> com.github.checkstyle.Class [47:5] | | |--HASH -> # [47:32] | | |--MEMBER -> constructor [47:33] | | `--PARAMETERS -> PARAMETERS [47:44] @@ -551,14 +515,12 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [47:50] | | |--ARGUMENT -> Type [47:51] | | `--RIGHT_BRACE -> ) [47:55] -| `--NEWLINE -> \r\n [47:56] +| `--NEWLINE -> \n [47:56] |--JAVADOC_TAG -> JAVADOC_TAG [48:0] | |--SEE_LITERAL -> @see [48:0] | |--WS -> [48:4] | |--REFERENCE -> REFERENCE [48:5] -| | |--PACKAGE -> com.github.checkstyle [48:5] -| | |--DOT -> . [48:26] -| | |--CLASS -> Class [48:27] +| | |--PACKAGE_CLASS -> com.github.checkstyle.Class [48:5] | | |--HASH -> # [48:32] | | |--MEMBER -> constructor [48:33] | | `--PARAMETERS -> PARAMETERS [48:44] @@ -572,53 +534,47 @@ JAVADOC -> JAVADOC [0:0] | | |--WS -> [48:63] | | |--ARGUMENT -> argname [48:64] | | `--RIGHT_BRACE -> ) [48:71] -| `--NEWLINE -> \r\n [48:72] +| `--NEWLINE -> \n [48:72] |--JAVADOC_TAG -> JAVADOC_TAG [49:0] | |--SEE_LITERAL -> @see [49:0] | |--WS -> [49:4] | |--REFERENCE -> REFERENCE [49:5] -| | |--PACKAGE -> com.github.checkstyle [49:5] -| | |--DOT -> . [49:26] -| | |--CLASS -> Class [49:27] -| | |--DOT -> . [49:32] -| | `--CLASS -> NestedClass [49:33] -| `--NEWLINE -> \r\n [49:44] +| | `--PACKAGE_CLASS -> com.github.checkstyle.Class.NestedClass [49:5] +| `--NEWLINE -> \n [49:44] |--JAVADOC_TAG -> JAVADOC_TAG [50:0] | |--SEE_LITERAL -> @see [50:0] | |--WS -> [50:4] | |--REFERENCE -> REFERENCE [50:5] -| | |--PACKAGE -> com.github.checkstyle [50:5] -| | |--DOT -> . [50:26] -| | `--CLASS -> Class [50:27] -| `--NEWLINE -> \r\n [50:32] +| | `--PACKAGE_CLASS -> com.github.checkstyle.Class [50:5] +| `--NEWLINE -> \n [50:32] |--JAVADOC_TAG -> JAVADOC_TAG [51:0] | |--SEE_LITERAL -> @see [51:0] | |--WS -> [51:4] | |--REFERENCE -> REFERENCE [51:5] -| | `--PACKAGE -> com.github.checkstyle [51:5] -| `--NEWLINE -> \r\n [51:26] +| | `--PACKAGE_CLASS -> com.github.checkstyle [51:5] +| `--NEWLINE -> \n [51:26] |--JAVADOC_TAG -> JAVADOC_TAG [52:0] | |--SERIAL_LITERAL -> @serial [52:0] | |--WS -> [52:7] | `--DESCRIPTION -> DESCRIPTION [52:8] | |--TEXT -> field description [52:8] -| |--NEWLINE -> \r\n [52:25] +| |--NEWLINE -> \n [52:25] | |--TEXT -> on few lines [53:0] -| |--NEWLINE -> \r\n [53:12] +| |--NEWLINE -> \n [53:12] | |--TEXT -> and even here [54:0] -| `--NEWLINE -> \r\n [54:13] +| `--NEWLINE -> \n [54:13] |--JAVADOC_TAG -> JAVADOC_TAG [55:0] | |--SERIAL_LITERAL -> @serial [55:0] | |--WS -> [55:7] | |--LITERAL_INCLUDE -> include [55:8] | `--DESCRIPTION -> DESCRIPTION [55:15] -| `--NEWLINE -> \r\n [55:15] +| `--NEWLINE -> \n [55:15] |--JAVADOC_TAG -> JAVADOC_TAG [56:0] | |--SERIAL_LITERAL -> @serial [56:0] | |--WS -> [56:7] | |--LITERAL_EXCLUDE -> exclude [56:8] | `--DESCRIPTION -> DESCRIPTION [56:15] -| `--NEWLINE -> \r\n [56:15] +| `--NEWLINE -> \n [56:15] |--JAVADOC_TAG -> JAVADOC_TAG [57:0] | |--SERIAL_FIELD_LITERAL -> @serialField [57:0] | |--WS -> [57:12] @@ -628,25 +584,25 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [57:40] | `--DESCRIPTION -> DESCRIPTION [57:41] | |--TEXT -> description of my serial field [57:41] -| `--NEWLINE -> \r\n [57:71] +| `--NEWLINE -> \n [57:71] |--JAVADOC_TAG -> JAVADOC_TAG [58:0] | |--SERIAL_DATA_LITERAL -> @serialData [58:0] | |--WS -> [58:11] | `--DESCRIPTION -> DESCRIPTION [58:12] | |--TEXT -> The data-description documents the types and order of data in the serialized form. Specifically, this data includes the optional data written by the writeObject method and all data (including base classes) written by the Externalizable.writeExternal method. [58:12] -| `--NEWLINE -> \r\n [58:269] +| `--NEWLINE -> \n [58:269] |--JAVADOC_TAG -> JAVADOC_TAG [59:0] | |--SINCE_LITERAL -> @since [59:0] | |--WS -> [59:6] | `--DESCRIPTION -> DESCRIPTION [59:7] | |--TEXT -> 1.5 [59:7] -| `--NEWLINE -> \r\n [59:10] +| `--NEWLINE -> \n [59:10] |--JAVADOC_TAG -> JAVADOC_TAG [60:0] | |--SINCE_LITERAL -> @since [60:0] | |--WS -> [60:6] | `--DESCRIPTION -> DESCRIPTION [60:7] | |--TEXT -> Release 3.4.5 [60:7] -| `--NEWLINE -> \r\n [60:20] +| `--NEWLINE -> \n [60:20] |--JAVADOC_TAG -> JAVADOC_TAG [61:0] | |--THROWS_LITERAL -> @throws [61:0] | |--WS -> [61:7] @@ -654,13 +610,13 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [61:19] | `--DESCRIPTION -> DESCRIPTION [61:20] | |--TEXT -> throws exception if connection refused. [61:20] -| `--NEWLINE -> \r\n [61:59] +| `--NEWLINE -> \n [61:59] |--JAVADOC_TAG -> JAVADOC_TAG [62:0] | |--VERSION_LITERAL -> @version [62:0] | |--WS -> [62:8] | `--DESCRIPTION -> DESCRIPTION [62:9] | |--TEXT -> 1.2 [62:9] -| `--NEWLINE -> \r\n [62:12] +| `--NEWLINE -> \n [62:12] |--JAVADOC_TAG -> JAVADOC_TAG [63:0] | |--VERSION_LITERAL -> @version [63:0] | |--WS -> [63:8] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAsteriskInJavadocInlineTagAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAsteriskInJavadocInlineTagAst.txt index 26d545f69d51..7ce4c35373d6 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAsteriskInJavadocInlineTagAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedAsteriskInJavadocInlineTagAst.txt @@ -2,10 +2,10 @@ JAVADOC -> JAVADOC [0:0] |--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG [0:0] | |--JAVADOC_INLINE_TAG_START -> { [0:0] | |--LINK_LITERAL -> @link [0:1] -| |--NEWLINE -> \r\n [0:6] +| |--NEWLINE -> \n [0:6] | |--LEADING_ASTERISK -> * [1:0] | |--WS -> [1:3] | |--REFERENCE -> REFERENCE [1:4] -| | `--CLASS -> GwtIncompatible [1:4] +| | `--PACKAGE_CLASS -> GwtIncompatible [1:4] | `--JAVADOC_INLINE_TAG_END -> } [1:19] `--EOF -> [1:20] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedDollarInLinkAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedDollarInLinkAst.txt index 4acb0939649f..cb6bdfa010f3 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedDollarInLinkAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedDollarInLinkAst.txt @@ -4,7 +4,7 @@ JAVADOC -> JAVADOC [0:0] | |--LINK_LITERAL -> @link [0:1] | |--WS -> [0:6] | |--REFERENCE -> REFERENCE [0:7] -| | |--CLASS -> My$Class [0:7] +| | |--PACKAGE_CLASS -> My$Class [0:7] | | |--HASH -> # [0:15] | | |--MEMBER -> $$simple_$Method [0:16] | | `--PARAMETERS -> PARAMETERS [0:32] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedJavadocTagDescriptionWithInlineTagsAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedJavadocTagDescriptionWithInlineTagsAst.txt index e02ca111c2e7..4118b7c580fa 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedJavadocTagDescriptionWithInlineTagsAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedJavadocTagDescriptionWithInlineTagsAst.txt @@ -9,9 +9,7 @@ JAVADOC -> JAVADOC [0:0] | | |--LINK_LITERAL -> @link [0:17] | | |--WS -> [0:22] | | |--REFERENCE -> REFERENCE [0:23] -| | | |--PACKAGE -> java.lang [0:23] -| | | |--DOT -> . [0:32] -| | | `--CLASS -> Integer [0:33] +| | | `--PACKAGE_CLASS -> java.lang.Integer [0:23] | | |--DESCRIPTION -> DESCRIPTION [0:40] | | | |--TEXT -> Integer [0:40] | | | `--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG [0:48] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkInlineTagsAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkInlineTagsAst.txt index 99ff1c522b1e..8e4252326e90 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkInlineTagsAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkInlineTagsAst.txt @@ -4,21 +4,17 @@ JAVADOC -> JAVADOC [0:0] | |--LINK_LITERAL -> @link [0:1] | |--WS -> [0:6] | |--REFERENCE -> REFERENCE [0:7] -| | |--PACKAGE -> java.lang [0:7] -| | |--DOT -> . [0:16] -| | |--CLASS -> Integer [0:17] +| | |--PACKAGE_CLASS -> java.lang.Integer [0:7] | | |--HASH -> # [0:24] | | `--MEMBER -> valueOf [0:25] | `--JAVADOC_INLINE_TAG_END -> } [0:32] -|--NEWLINE -> \r\n [0:33] +|--NEWLINE -> \n [0:33] |--JAVADOC_INLINE_TAG -> JAVADOC_INLINE_TAG [1:0] | |--JAVADOC_INLINE_TAG_START -> { [1:0] | |--LINK_LITERAL -> @link [1:1] | |--WS -> [1:6] | |--REFERENCE -> REFERENCE [1:7] -| | |--PACKAGE -> java.lang [1:7] -| | |--DOT -> . [1:16] -| | |--CLASS -> Integer [1:17] +| | |--PACKAGE_CLASS -> java.lang.Integer [1:7] | | |--HASH -> # [1:24] | | `--MEMBER -> valueOf [1:25] | |--DESCRIPTION -> DESCRIPTION [1:32] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkToPackageAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkToPackageAst.txt index cd2153d90e78..b1b638a62ae0 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkToPackageAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedLinkToPackageAst.txt @@ -4,7 +4,7 @@ JAVADOC -> JAVADOC [0:0] | |--LINK_LITERAL -> @link [0:1] | |--WS -> [0:6] | |--REFERENCE -> REFERENCE [0:7] -| | `--PACKAGE -> _com._1organizationname.appname [0:7] +| | `--PACKAGE_CLASS -> _com._1organizationname.appname [0:7] | `--JAVADOC_INLINE_TAG_END -> } [0:38] -|--NEWLINE -> \r\n [0:39] +|--NEWLINE -> \n [0:39] `--EOF -> [1:0] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedNewlineAndAsteriskInParametersAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedNewlineAndAsteriskInParametersAst.txt index 1b62864c90e7..71980ab85747 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedNewlineAndAsteriskInParametersAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedNewlineAndAsteriskInParametersAst.txt @@ -6,14 +6,14 @@ JAVADOC -> JAVADOC [0:0] | |--LINK_LITERAL -> @link [0:5] | |--WS -> [0:10] | |--REFERENCE -> REFERENCE [0:11] -| | |--CLASS -> ImmutableSortedMap [0:11] +| | |--PACKAGE_CLASS -> ImmutableSortedMap [0:11] | | |--HASH -> # [0:29] | | |--MEMBER -> of [0:30] | | `--PARAMETERS -> PARAMETERS [0:32] | | |--LEFT_BRACE -> ( [0:32] -| | |--NEWLINE -> \r\n [0:33] +| | |--NEWLINE -> \n [0:33] | | |--LEADING_ASTERISK -> * [1:0] -| | |--NEWLINE -> \r\n [1:3] +| | |--NEWLINE -> \n [1:3] | | |--LEADING_ASTERISK -> * [2:0] | | |--WS -> [2:3] | | `--RIGHT_BRACE -> ) [2:4] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedSeeReferenceWithFewNestedClassesAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedSeeReferenceWithFewNestedClassesAst.txt index 5523b672922b..11bbefb8688e 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedSeeReferenceWithFewNestedClassesAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedSeeReferenceWithFewNestedClassesAst.txt @@ -3,13 +3,7 @@ JAVADOC -> JAVADOC [0:0] | |--SEE_LITERAL -> @see [0:0] | |--WS -> [0:4] | |--REFERENCE -> REFERENCE [0:5] -| | |--PACKAGE -> java.lang [0:5] -| | |--DOT -> . [0:14] -| | |--CLASS -> Integer [0:15] -| | |--DOT -> . [0:22] -| | |--CLASS -> Nested [0:23] -| | |--DOT -> . [0:29] -| | |--CLASS -> AnotherNested [0:30] +| | |--PACKAGE_CLASS -> java.lang.Integer.Nested.AnotherNested [0:5] | | |--HASH -> # [0:43] | | |--MEMBER -> someMethod [0:44] | | `--PARAMETERS -> PARAMETERS [0:54] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedTextBeforeJavadocTagsAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedTextBeforeJavadocTagsAst.txt index 24ef3995bf8b..29f6fa7f8b49 100644 --- a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedTextBeforeJavadocTagsAst.txt +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedTextBeforeJavadocTagsAst.txt @@ -1,22 +1,22 @@ JAVADOC -> JAVADOC [0:0] -|--NEWLINE -> \r\n [0:0] +|--NEWLINE -> \n [0:0] |--LEADING_ASTERISK -> * [1:0] |--TEXT -> a b [1:2] -|--NEWLINE -> \r\n [1:6] +|--NEWLINE -> \n [1:6] |--LEADING_ASTERISK -> * [2:0] |--TEXT -> c [2:2] -|--NEWLINE -> \r\n [2:4] +|--NEWLINE -> \n [2:4] |--LEADING_ASTERISK -> * [3:0] |--WS -> [3:2] |--JAVADOC_TAG -> JAVADOC_TAG [3:3] | |--SEE_LITERAL -> @see [3:3] | |--WS -> [3:7] | |--REFERENCE -> REFERENCE [3:8] -| | `--CLASS -> Integer [3:8] +| | `--PACKAGE_CLASS -> Integer [3:8] | |--WS -> [3:15] | `--DESCRIPTION -> DESCRIPTION [3:16] | |--TEXT -> Int [3:16] -| `--NEWLINE -> \r\n [3:19] +| `--NEWLINE -> \n [3:19] |--LEADING_ASTERISK -> * [4:0] |--WS -> [4:2] |--JAVADOC_TAG -> JAVADOC_TAG [4:3] @@ -24,7 +24,7 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [4:10] | `--DESCRIPTION -> DESCRIPTION [4:11] | |--TEXT -> Walter White [4:11] -| `--NEWLINE -> \r\n [4:23] +| `--NEWLINE -> \n [4:23] |--LEADING_ASTERISK -> * [5:0] |--WS -> [5:2] |--JAVADOC_TAG -> JAVADOC_TAG [5:3] @@ -32,6 +32,6 @@ JAVADOC -> JAVADOC [0:0] | |--WS -> [5:10] | `--DESCRIPTION -> DESCRIPTION [5:11] | |--TEXT -> John Snow [5:11] -| |--NEWLINE -> \r\n [5:20] +| |--NEWLINE -> \n [5:20] | `--TEXT -> [6:0] `--EOF -> [6:1] diff --git a/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedUppercaseInPackageNameAst.txt b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedUppercaseInPackageNameAst.txt new file mode 100644 index 000000000000..508ae0e9a21b --- /dev/null +++ b/src/test/resources/com/puppycrawl/tools/checkstyle/grammars/javadoc/javadocTags/expectedUppercaseInPackageNameAst.txt @@ -0,0 +1,282 @@ +JAVADOC -> JAVADOC [0:0] +|--LEADING_ASTERISK -> * [0:0] +|--WS -> [0:1] +|--JAVADOC_TAG -> JAVADOC_TAG [0:2] +| |--SEE_LITERAL -> @see [0:2] +| |--WS -> [0:6] +| |--REFERENCE -> REFERENCE [0:7] +| | |--HASH -> # [0:7] +| | `--MEMBER -> fn [0:8] +| `--NEWLINE -> \n [0:10] +|--LEADING_ASTERISK -> * [1:0] +|--WS -> [1:1] +|--JAVADOC_TAG -> JAVADOC_TAG [1:2] +| |--SEE_LITERAL -> @see [1:2] +| |--WS -> [1:6] +| |--REFERENCE -> REFERENCE [1:7] +| | |--HASH -> # [1:7] +| | `--MEMBER -> FN [1:8] +| `--NEWLINE -> \n [1:10] +|--LEADING_ASTERISK -> * [2:0] +|--WS -> [2:1] +|--JAVADOC_TAG -> JAVADOC_TAG [2:2] +| |--SEE_LITERAL -> @see [2:2] +| |--WS -> [2:6] +| |--REFERENCE -> REFERENCE [2:7] +| | |--HASH -> # [2:7] +| | |--MEMBER -> C [2:8] +| | `--PARAMETERS -> PARAMETERS [2:9] +| | |--LEFT_BRACE -> ( [2:9] +| | |--ARGUMENT -> Type [2:10] +| | `--RIGHT_BRACE -> ) [2:14] +| `--NEWLINE -> \n [2:15] +|--LEADING_ASTERISK -> * [3:0] +|--WS -> [3:1] +|--JAVADOC_TAG -> JAVADOC_TAG [3:2] +| |--SEE_LITERAL -> @see [3:2] +| |--WS -> [3:6] +| |--REFERENCE -> REFERENCE [3:7] +| | |--HASH -> # [3:7] +| | |--MEMBER -> CN [3:8] +| | `--PARAMETERS -> PARAMETERS [3:10] +| | |--LEFT_BRACE -> ( [3:10] +| | |--ARGUMENT -> Type [3:11] +| | |--WS -> [3:15] +| | |--ARGUMENT -> id [3:16] +| | `--RIGHT_BRACE -> ) [3:18] +| `--NEWLINE -> \n [3:19] +|--LEADING_ASTERISK -> * [4:0] +|--WS -> [4:1] +|--JAVADOC_TAG -> JAVADOC_TAG [4:2] +| |--SEE_LITERAL -> @see [4:2] +| |--WS -> [4:6] +| |--REFERENCE -> REFERENCE [4:7] +| | |--HASH -> # [4:7] +| | |--MEMBER -> mN [4:8] +| | `--PARAMETERS -> PARAMETERS [4:10] +| | |--LEFT_BRACE -> ( [4:10] +| | |--ARGUMENT -> Type [4:11] +| | |--WS -> [4:15] +| | |--ARGUMENT -> id [4:16] +| | |--COMMA -> , [4:18] +| | |--WS -> [4:19] +| | |--ARGUMENT -> Type [4:20] +| | |--COMMA -> , [4:24] +| | |--WS -> [4:25] +| | |--ARGUMENT -> Type [4:26] +| | |--WS -> [4:30] +| | |--ARGUMENT -> id [4:31] +| | `--RIGHT_BRACE -> ) [4:33] +| `--NEWLINE -> \n [4:34] +|--LEADING_ASTERISK -> * [5:0] +|--WS -> [5:1] +|--JAVADOC_TAG -> JAVADOC_TAG [5:2] +| |--SEE_LITERAL -> @see [5:2] +| |--WS -> [5:6] +| |--REFERENCE -> REFERENCE [5:7] +| | |--PACKAGE_CLASS -> CN [5:7] +| | |--HASH -> # [5:9] +| | `--MEMBER -> fieldName [5:10] +| `--NEWLINE -> \n [5:19] +|--LEADING_ASTERISK -> * [6:0] +|--WS -> [6:1] +|--JAVADOC_TAG -> JAVADOC_TAG [6:2] +| |--SEE_LITERAL -> @see [6:2] +| |--WS -> [6:6] +| |--REFERENCE -> REFERENCE [6:7] +| | |--PACKAGE_CLASS -> CN [6:7] +| | |--HASH -> # [6:9] +| | `--MEMBER -> fn [6:10] +| `--NEWLINE -> \n [6:12] +|--LEADING_ASTERISK -> * [7:0] +|--WS -> [7:1] +|--JAVADOC_TAG -> JAVADOC_TAG [7:2] +| |--SEE_LITERAL -> @see [7:2] +| |--WS -> [7:6] +| |--REFERENCE -> REFERENCE [7:7] +| | |--PACKAGE_CLASS -> name [7:7] +| | |--HASH -> # [7:11] +| | `--MEMBER -> FN [7:12] +| `--NEWLINE -> \n [7:14] +|--LEADING_ASTERISK -> * [8:0] +|--WS -> [8:1] +|--JAVADOC_TAG -> JAVADOC_TAG [8:2] +| |--SEE_LITERAL -> @see [8:2] +| |--WS -> [8:6] +| |--REFERENCE -> REFERENCE [8:7] +| | |--PACKAGE_CLASS -> CN [8:7] +| | |--HASH -> # [8:9] +| | |--MEMBER -> C [8:10] +| | `--PARAMETERS -> PARAMETERS [8:11] +| | |--LEFT_BRACE -> ( [8:11] +| | |--ARGUMENT -> Type [8:12] +| | `--RIGHT_BRACE -> ) [8:16] +| `--NEWLINE -> \n [8:17] +|--LEADING_ASTERISK -> * [9:0] +|--WS -> [9:1] +|--JAVADOC_TAG -> JAVADOC_TAG [9:2] +| |--SEE_LITERAL -> @see [9:2] +| |--WS -> [9:6] +| |--REFERENCE -> REFERENCE [9:7] +| | |--PACKAGE_CLASS -> CN [9:7] +| | |--HASH -> # [9:9] +| | |--MEMBER -> CN [9:10] +| | `--PARAMETERS -> PARAMETERS [9:12] +| | |--LEFT_BRACE -> ( [9:12] +| | |--ARGUMENT -> Type [9:13] +| | |--WS -> [9:17] +| | |--ARGUMENT -> id [9:18] +| | `--RIGHT_BRACE -> ) [9:20] +| `--NEWLINE -> \n [9:21] +|--LEADING_ASTERISK -> * [10:0] +|--WS -> [10:1] +|--JAVADOC_TAG -> JAVADOC_TAG [10:2] +| |--SEE_LITERAL -> @see [10:2] +| |--WS -> [10:6] +| |--REFERENCE -> REFERENCE [10:7] +| | |--PACKAGE_CLASS -> CN [10:7] +| | |--HASH -> # [10:9] +| | |--MEMBER -> mN [10:10] +| | `--PARAMETERS -> PARAMETERS [10:12] +| | |--LEFT_BRACE -> ( [10:12] +| | |--ARGUMENT -> Type [10:13] +| | |--WS -> [10:17] +| | |--ARGUMENT -> id [10:18] +| | |--COMMA -> , [10:20] +| | |--WS -> [10:21] +| | |--ARGUMENT -> Type [10:22] +| | |--COMMA -> , [10:26] +| | |--WS -> [10:27] +| | |--ARGUMENT -> Type [10:28] +| | |--WS -> [10:32] +| | |--ARGUMENT -> id [10:33] +| | `--RIGHT_BRACE -> ) [10:35] +| `--NEWLINE -> \n [10:36] +|--LEADING_ASTERISK -> * [11:0] +|--WS -> [11:1] +|--JAVADOC_TAG -> JAVADOC_TAG [11:2] +| |--SEE_LITERAL -> @see [11:2] +| |--WS -> [11:6] +| |--REFERENCE -> REFERENCE [11:7] +| | |--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName.ClassName [11:7] +| | |--HASH -> # [11:58] +| | `--MEMBER -> fieldName [11:59] +| `--NEWLINE -> \n [11:68] +|--LEADING_ASTERISK -> * [12:0] +|--WS -> [12:1] +|--JAVADOC_TAG -> JAVADOC_TAG [12:2] +| |--SEE_LITERAL -> @see [12:2] +| |--WS -> [12:6] +| |--REFERENCE -> REFERENCE [12:7] +| | |--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName.ClassName [12:7] +| | |--HASH -> # [12:58] +| | `--MEMBER -> fn [12:59] +| `--NEWLINE -> \n [12:61] +|--LEADING_ASTERISK -> * [13:0] +|--WS -> [13:1] +|--JAVADOC_TAG -> JAVADOC_TAG [13:2] +| |--SEE_LITERAL -> @see [13:2] +| |--WS -> [13:6] +| |--REFERENCE -> REFERENCE [13:7] +| | |--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName.ClassName [13:7] +| | |--HASH -> # [13:58] +| | `--MEMBER -> FN [13:59] +| `--NEWLINE -> \n [13:61] +|--LEADING_ASTERISK -> * [14:0] +|--WS -> [14:1] +|--JAVADOC_TAG -> JAVADOC_TAG [14:2] +| |--SEE_LITERAL -> @see [14:2] +| |--WS -> [14:6] +| |--REFERENCE -> REFERENCE [14:7] +| | |--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName.ClassName [14:7] +| | |--HASH -> # [14:58] +| | |--MEMBER -> C [14:59] +| | `--PARAMETERS -> PARAMETERS [14:60] +| | |--LEFT_BRACE -> ( [14:60] +| | |--ARGUMENT -> Type [14:61] +| | `--RIGHT_BRACE -> ) [14:65] +| `--NEWLINE -> \n [14:66] +|--LEADING_ASTERISK -> * [15:0] +|--WS -> [15:1] +|--JAVADOC_TAG -> JAVADOC_TAG [15:2] +| |--SEE_LITERAL -> @see [15:2] +| |--WS -> [15:6] +| |--REFERENCE -> REFERENCE [15:7] +| | |--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName.ClassName [15:7] +| | |--HASH -> # [15:58] +| | |--MEMBER -> CN [15:59] +| | `--PARAMETERS -> PARAMETERS [15:61] +| | |--LEFT_BRACE -> ( [15:61] +| | |--ARGUMENT -> Type [15:62] +| | |--WS -> [15:66] +| | |--ARGUMENT -> id [15:67] +| | `--RIGHT_BRACE -> ) [15:69] +| `--NEWLINE -> \n [15:70] +|--LEADING_ASTERISK -> * [16:0] +|--WS -> [16:1] +|--JAVADOC_TAG -> JAVADOC_TAG [16:2] +| |--SEE_LITERAL -> @see [16:2] +| |--WS -> [16:6] +| |--REFERENCE -> REFERENCE [16:7] +| | |--PACKAGE_CLASS -> pn.CN [16:7] +| | |--HASH -> # [16:12] +| | |--MEMBER -> mN [16:13] +| | `--PARAMETERS -> PARAMETERS [16:15] +| | |--LEFT_BRACE -> ( [16:15] +| | |--ARGUMENT -> Type [16:16] +| | |--WS -> [16:20] +| | |--ARGUMENT -> id [16:21] +| | |--COMMA -> , [16:23] +| | |--WS -> [16:24] +| | |--ARGUMENT -> Type [16:25] +| | |--COMMA -> , [16:29] +| | |--WS -> [16:30] +| | |--ARGUMENT -> Type [16:31] +| | |--WS -> [16:35] +| | |--ARGUMENT -> id [16:36] +| | `--RIGHT_BRACE -> ) [16:38] +| `--NEWLINE -> \n [16:39] +|--LEADING_ASTERISK -> * [17:0] +|--WS -> [17:1] +|--JAVADOC_TAG -> JAVADOC_TAG [17:2] +| |--SEE_LITERAL -> @see [17:2] +| |--WS -> [17:6] +| |--REFERENCE -> REFERENCE [17:7] +| | |--PACKAGE_CLASS -> pn.CN [17:7] +| | |--HASH -> # [17:12] +| | `--MEMBER -> FN [17:13] +| `--NEWLINE -> \n [17:15] +|--LEADING_ASTERISK -> * [18:0] +|--WS -> [18:1] +|--JAVADOC_TAG -> JAVADOC_TAG [18:2] +| |--SEE_LITERAL -> @see [18:2] +| |--WS -> [18:6] +| |--REFERENCE -> REFERENCE [18:7] +| | |--PACKAGE_CLASS -> pn.CN [18:7] +| | |--HASH -> # [18:12] +| | `--MEMBER -> m [18:13] +| `--NEWLINE -> \n [18:14] +|--LEADING_ASTERISK -> * [19:0] +|--WS -> [19:1] +|--JAVADOC_TAG -> JAVADOC_TAG [19:2] +| |--SEE_LITERAL -> @see [19:2] +| |--WS -> [19:6] +| |--REFERENCE -> REFERENCE [19:7] +| | `--PACKAGE_CLASS -> lowercase.UPPERCASE.CamelCase.packageName [19:7] +| `--NEWLINE -> \n [19:48] +|--LEADING_ASTERISK -> * [20:0] +|--WS -> [20:1] +|--JAVADOC_TAG -> JAVADOC_TAG [20:2] +| |--SEE_LITERAL -> @see [20:2] +| |--WS -> [20:6] +| |--REFERENCE -> REFERENCE [20:7] +| | `--PACKAGE_CLASS -> pn.p [20:7] +| `--NEWLINE -> \n [20:11] +|--LEADING_ASTERISK -> * [21:0] +|--WS -> [21:1] +|--JAVADOC_TAG -> JAVADOC_TAG [21:2] +| |--SEE_LITERAL -> @see [21:2] +| |--WS -> [21:6] +| `--REFERENCE -> REFERENCE [21:7] +| `--PACKAGE_CLASS -> pn [21:7] +`--EOF -> [21:9]