Issue #3209: add example to TokenTypes for FOR_EACH_CLAUSE

src/main/java/com/puppycrawl/tools/checkstyle/api/TokenTypes.java

@@ -2858,6 +2858,37 @@ public final class TokenTypes {
      * <code>LITERAL_FOR</code>.  The children of this element may be
      * a parameter definition, the colon literal and an expression.
      *
+     * <p>For example:</p>
+     * <pre>
+     * for (int value : values) {
+     *     doSmth();
+     * }
+     * </pre>
+     * <p>parses as:</p>
+     * <pre>
+     * --LITERAL_FOR (for)
+     *    |--LPAREN (()
+     *    |--FOR_EACH_CLAUSE
+     *    |   |--VARIABLE_DEF
+     *    |   |   |--MODIFIERS
+     *    |   |   |--TYPE
+     *    |   |   |   `--LITERAL_INT (int)
+     *    |   |   `--IDENT (value)
+     *    |   |--COLON (:)
+     *    |   `--EXPR
+     *    |       `--IDENT (values
+     *    |--RPAREN ())
+     *    `--SLIST ({)
+     *        |--EXPR
+     *        |   `--METHOD_CALL (()
+     *        |       |--IDENT (doSmth)
+     *        |       |--ELIST
+     *        |       `--RPAREN ())
+     *        |--SEMI (;)
+     *        `--RCURLY (})
+     *
+     * </pre>
+     *
      * @see #VARIABLE_DEF
      * @see #ELIST
      * @see #LITERAL_FOR