xiazcy commented on code in PR #3458:
URL: https://github.com/apache/tinkerpop/pull/3458#discussion_r3431788213
##########
gremlin-core/src/main/java/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.java:
##########
@@ -414,6 +415,23 @@ public default GraphTraversal<S, Vertex> V(final Object...
vertexIdsOrElements)
return this.asAdmin().addStep(step);
}
+ /**
+ * A {@code V} step that accepts a child traversal whose results are used
as vertex IDs for lookup.
+ * This form is only valid as a mid-traversal step; using it as a start
step will throw an
+ * {@link IllegalStateException} at runtime because there is no traverser
context to evaluate the child traversal.
Review Comment:
```suggestion
* A {@code V} step that accepts a child traversal whose results are
used as vertex IDs for lookup.
* This form works both as a mid-traversal step (where the current
traverser seeds the child traversal)
* and as a start step via {@link GraphTraversalSource#V(Traversal)}
(where a synthetic traverser is
* generated to seed the child traversal, consistent with {@code
mergeV(traversal)} behavior).traversal.
```
Note stale javadoc
--
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]
