This is an automated email from the ASF dual-hosted git repository.
paulk pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/groovy.git
commit e319e6acbc6457e798651b65d265655851e22214
Author: Paul King <pa...@asert.com.au>
AuthorDate: Tue Aug 5 21:23:58 2025 +1000
GROOVY-8162: Update Groovysh to JLine3 (document exception handling)
---
.../src/spec/doc/assets/img/repl_exceptions.png | Bin 0 -> 437859 bytes
subprojects/groovy-groovysh/src/spec/doc/groovysh.adoc | 8 ++++++++
2 files changed, 8 insertions(+)
diff --git
a/subprojects/groovy-groovysh/src/spec/doc/assets/img/repl_exceptions.png
b/subprojects/groovy-groovysh/src/spec/doc/assets/img/repl_exceptions.png
new file mode 100644
index 0000000000..53e9350f9b
Binary files /dev/null and
b/subprojects/groovy-groovysh/src/spec/doc/assets/img/repl_exceptions.png differ
diff --git a/subprojects/groovy-groovysh/src/spec/doc/groovysh.adoc
b/subprojects/groovy-groovysh/src/spec/doc/groovysh.adoc
index 8bf02ce850..ba2dd49304 100644
--- a/subprojects/groovy-groovysh/src/spec/doc/groovysh.adoc
+++ b/subprojects/groovy-groovysh/src/spec/doc/groovysh.adoc
@@ -269,6 +269,14 @@ Internally the shell creates a closure to encapsulate the
function and
then binds the closure to a variable. So variables and functions share
the same namespace.
+[[GroovyShell-Exceptions]]
+==== Exceptions
+
+If an exception is thrown, the shell will print the exception message
+and set a special `exception` shared variable.
+
+image:assets/img/repl_exceptions.png[Exception, width=80%]
+
[[GroovyShell-Commands]]
=== Commands
