daniellansun opened a new pull request, #3299: URL: https://github.com/apache/groovy/pull/3299
This updates the in-tree AsciiDoc so it matches current `master`. The implementation and tests on this tip are the source of truth; the published release notes were used only as a historical reference. Nothing from unmerged work is documented here. The main corrections: - Invokedynamic is the default since Groovy 4. The old dual-jar / `indy/` / `groovy --indy` story is removed. Classic call sites need the optional `groovy-callsite` module. - The documented JDK baseline is 17, with bytecode levels 17 through 28, following the compiler and the CI matrix. - Parser tuning now includes `groovy.antlr4.cache.size`, and the default and meaning of `groovy.antlr4.cache.threshold` match the current `AtnManager`. - `groovyc` / `groovy` flag tables include the switches the tools actually accept (`--compile-static`, `--type-checked`, stubs, and so on). Obsolete Java 6 / Java 8 and Cobertura examples are replaced. - Grape documents the shipped Ivy timeouts, `-Dgrape.config`, and the `-i` / `-d` clash on `grape resolve`. The Jetty examples use Jetty 12.1 `ee11`, which matches `groovy-servlet` on Jakarta EE 11. - `@NamedVariant` now has a section, aligned with the annotation and with GROOVY-10498 / GROOVY-12762. - A number of wording mistakes are fixed: closure `this` / `owner` are enclosing instances, `it` is not a keyword, `==` follows `DefaultTypeTransformation.compareEqual`, JSON / YAML / TOML `parse` methods return structured values, and TOML has no null. Broken links that were fixed include the Java 7 `BigDecimal` API URLs, a concatenated `ChronoUnit#DAYS` URL, the missing default Grape Ivy settings path, and `gapi:groovy.util.CliBuilder` (removed in Groovy 3). Left as follow-ups, if maintainers want them: - Some older `@Grab` examples were not re-resolved. - The `groovy` / `groovyc` / `groovyConsole` help strings still say "jdk8+" and "jdk12+". The pages quote that help rather than changing the programs. - `version-scheme.adoc` still describes the post-2.0 scheme and does not name the current development line. It is not included in the user manual. - `_streaming-jason-builder.adoc` is misspelled; the include already matches the filename. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
