You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@groovy.apache.org by pa...@apache.org on 2026/05/16 22:22:23 UTC
(groovy-website) 02/02: minor release note tweaks
This is an automated email from the ASF dual-hosted git repository.
paulk-asert pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/groovy-website.git
commit 3405d0a2fb7fb5c30aa4b51c636ed2c3f5326d0f
Author: Paul King <pa...@asert.com.au>
AuthorDate: Sun May 17 08:22:14 2026 +1000
minor release note tweaks
---
site/src/site/releasenotes/groovy-6.0.adoc | 23 ++++++++++++++++++++++-
1 file changed, 22 insertions(+), 1 deletion(-)
diff --git a/site/src/site/releasenotes/groovy-6.0.adoc b/site/src/site/releasenotes/groovy-6.0.adoc
index 016ef7c..99ee649 100644
--- a/site/src/site/releasenotes/groovy-6.0.adoc
+++ b/site/src/site/releasenotes/groovy-6.0.adoc
@@ -1394,6 +1394,12 @@ The full specification for sealed types is in
link:../wiki/GEP-13.html[GEP-13: Sealed Types], which was revised
alongside the 6.0 graduation.
+* The `groovy-toml` module -- introduced as an incubating module in
+Groovy 4.0 -- is *promoted out of incubation in Groovy 6.0*
+(https://issues.apache.org/jira/browse/GROOVY-12010[GROOVY-12010]).
+Its public API is now covenanted and subject to binary-compatibility
+checks.
+
[[g6-extensions]]
== Extension method additions and improvements
@@ -1792,12 +1798,27 @@ def config = new XmlParser().parseTextAs(ServerConfig, xml)
| --
|===
-NOTE: For CSV, TOML, YAML, and XML, the `parseTextAs`/`parseAs` methods use
+[NOTE]
+====
+For CSV, TOML, YAML, and XML, the `parseTextAs`/`parseAs` methods use
Jackson databinding and support `@JsonProperty`, `@JsonFormat`, etc.
For simple cases, Groovy's `as` coercion works without Jackson.
For XML, `jackson-dataformat-xml` can be used directly for full
Jackson XML annotation support.
+The typed parse/write paths for CSV, TOML and YAML support `java.time`
+types -- `LocalDate`, `LocalTime`, `LocalDateTime` and `OffsetDateTime`
+-- with `OffsetDateTime` retaining its original zone offset rather than
+being normalised to UTC
+(https://issues.apache.org/jira/browse/GROOVY-12010[GROOVY-12010],
+https://issues.apache.org/jira/browse/GROOVY-12011[GROOVY-12011],
+https://issues.apache.org/jira/browse/GROOVY-12012[GROOVY-12012]).
+Date and time values (including legacy `java.util.Date`/`Calendar`) are
+written as ISO-8601 strings, not numeric timestamps. The *untyped*
+slurper path (`parseText`/`parse`) returns temporal values as `String`;
+use the typed `parseAs`/`parseTextAs` API for `java.time` fidelity.
+====
+
[[xml-processing]]
== XML Processing Improvements