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]

Reply via email to