(groovy-website) branch asf-site updated: latest groovydoc features

[pa...@apache.org]

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


The following commit(s) were added to refs/heads/asf-site by this push:
     new 13f27a9  latest groovydoc features
13f27a9 is described below

commit 13f27a9e84c391863337230edfacf8840dcb534e
Author: Paul King <pa...@asert.com.au>
AuthorDate: Wed Apr 22 10:26:49 2026 +1000

    latest groovydoc features
---
 site/src/site/releasenotes/groovy-6.0.adoc | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/site/src/site/releasenotes/groovy-6.0.adoc b/site/src/site/releasenotes/groovy-6.0.adoc
index cd76090..c53e72c 100644
--- a/site/src/site/releasenotes/groovy-6.0.adoc
+++ b/site/src/site/releasenotes/groovy-6.0.adoc
@@ -1357,6 +1357,15 @@ itself:
 https://openjdk.org/jeps/413[JEP 413] for the full markup
 reference.
 
+Two author-facing conveniences apply to the external form: the
+language class is inferred from the file's extension when no
+explicit `lang="..."` is given, and a leading license or copyright
+header in the referenced file is stripped from the rendered output
+(opt out with `keepHeader=true`). See the
+https://docs.groovy-lang.org/docs/next/html/documentation/groovydoc.html[Groovydoc
+documentation] for the full list of recognised extensions and the
+header-detection heuristic.
+
 === Syntax highlighting and dark mode
 
 Two new generator flags make the rendered output immediately more
@@ -1390,6 +1399,17 @@ semantic CSS custom properties (`--fg`, `--bg`, `--link`,
 `--add-stylesheet` can reference the same tokens and become theme-aware
 automatically.
 
+=== Highlighting legacy `<pre>` blocks
+
+The new `-preLanguage <lang>` option (CLI) / `preLanguage="lang"`
+attribute (Ant task) sets a default Prism language for unattributed
+`<pre>` blocks in doc comments, so legacy code samples get
+highlighted without source edits
+(https://issues.apache.org/jira/browse/GROOVY-11950[GROOVY-11950]).
+See the
+https://docs.groovy-lang.org/docs/next/html/documentation/groovydoc.html[Groovydoc
+documentation] for the rewrite rules and the per-block opt-out.
+
 === Feature summary
 
 Smaller improvements that collectively close the long-standing gap