spmallette commented on code in PR #3458:
URL: https://github.com/apache/tinkerpop/pull/3458#discussion_r3423923145
##########
docs/src/reference/the-traversal.asciidoc:
##########
@@ -3989,6 +4026,21 @@ g.addV().property(set, null)
<7> The label value can be specified as a property only at the time a vertex
is added and if one is not specified in the addV()
<8> If you pass a `null` value for the Map this will be treated as a no-op and
the input will be returned
+The `property()` step also accepts a traversal that produces a `Map` of
key-value pairs to set as properties. The
+child traversal must be read-only - mutating steps are rejected. If the
traversal does not produce a `Map`, the result
+is rejected. Each entry in the resulting Map becomes a separate property on
the element, allowing multiple properties
+to be set in a single step.
+
+[gremlin-groovy,modern]
+----
+g.V(4).property(__.V(1).project('friendCount','createdSoftware').by(__.out('knows').count()).by(__.out('created').values('name')))
<1>
+g.V(4).valueMap('friendCount','createdSoftware')
+----
+
+<1> Set two properties on vertex 4 (josh) from a Map produced by a child
traversal. The `project()` step builds a Map
Review Comment:
if you get a better multi-line formatting as i mentioned above, then this
description can be broken into smaller bits for folks to understand more easily
--
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]
