This is an automated email from the ASF dual-hosted git repository.
spmallette pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/master by this push:
new e3df8edaa7 Fix exception type in ReadOnlyStrategy reference docs
e3df8edaa7 is described below
commit e3df8edaa7aa44eacddf149500dd4357ca164f5a
Author: Stephen Mallette <[email protected]>
AuthorDate: Fri Sep 11 21:44:11 2026 +0000
Fix exception type in ReadOnlyStrategy reference docs
The prose stated that a mutating traversal throws an IllegalStateException,
while the accompanying code comments referred to a VerificationException.
Make the prose precise and consistent by naming VerificationException and
noting it is a subclass of IllegalStateException, and align the JavaScript
and Python comments to the error types those clients actually surface
(ResponseError and GremlinServerError).
Assisted-by: Kiro:claude-opus-4.8
---
docs/src/reference/the-traversal.asciidoc | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index 1a00de8d43..8a1269c6a7 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -7300,8 +7300,8 @@ to merge those multiple graphs (i.e. join partitions).
[[readonlystrategy]]
=== ReadOnlyStrategy
-`ReadOnlyStrategy` is largely self-explanatory. A `Traversal` that has this
strategy applied will throw an
-`IllegalStateException` if the `Traversal` has any mutating steps within it.
+`ReadOnlyStrategy` is largely self-explanatory. A `Traversal` that has this
strategy applied will throw a
+`VerificationException` (a subclass of `IllegalStateException`) if the
`Traversal` has any mutating steps within it.
[source,java,tab]
----
@@ -7321,12 +7321,12 @@ g.WithStrategies(new
ReadOnlyStrategy()).addV("person").Iterate();
----
[source,javascript]
----
-// results in Error
+// results in ResponseError
g.withStrategies(new ReadOnlyStrategy()).addV("person").iterate();
----
[source,python]
----
-// results in Error
+// results in GremlinServerError
g.withStrategies(ReadOnlyStrategy).addV("person").iterate()
----