Issue #17882: Add STRING_LITERAL token Javadoc with AST example

YuktiNandwana · romani · commit 8ffb662c70ce · 2026-02-05T09:39:41.000-08:00
diff --git a/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocCommentsTokenTypes.java b/src/main/java/com/puppycrawl/tools/checkstyle/api/JavadocCommentsTokenTypes.java
@@ -1934,6 +1934,23 @@ public final class JavadocCommentsTokenTypes {
 
     /**
      * String literal inside Javadoc.
+     *
+     * <p>Example in Javadoc:</p>
+     *
+     * <pre>{@code
+     * {@see "foo"}
+     * }</pre>
+     *
+     * <p>Tree:</p>
+     *
+     * <pre>{@code
+     * JAVADOC_BLOCK_TAG -> JAVADOC_BLOCK_TAG
+     * `--SEE_BLOCK_TAG -> SEE_BLOCK_TAG
+     *     |--AT_SIGN -> @
+     *     |--TAG_NAME -> see
+     *     |--TEXT ->
+     *     `--STRING_LITERAL -> "foo"
+     * }</pre>
      */
     public static final int STRING_LITERAL = JavadocCommentsLexer.STRING_LITERAL;
 
