per @spmallette's request, added where().by() to the upgrading user-docs.
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/8febc4da Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/8febc4da Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/8febc4da Branch: refs/heads/TINKERPOP-1404 Commit: 8febc4dac44c893dc263a4ca5fd340f4bf7b4d94 Parents: fe21ce1 Author: Marko A. Rodriguez <okramma...@gmail.com> Authored: Thu Sep 15 07:58:09 2016 -0600 Committer: Marko A. Rodriguez <okramma...@gmail.com> Committed: Thu Sep 15 09:58:53 2016 -0600 ---------------------------------------------------------------------- .../upgrade/release-3.2.x-incubating.asciidoc | 27 ++++++++++++++++++++ 1 file changed, 27 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/8febc4da/docs/src/upgrade/release-3.2.x-incubating.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/upgrade/release-3.2.x-incubating.asciidoc b/docs/src/upgrade/release-3.2.x-incubating.asciidoc index 61e3a58..2cf8ef2 100644 --- a/docs/src/upgrade/release-3.2.x-incubating.asciidoc +++ b/docs/src/upgrade/release-3.2.x-incubating.asciidoc @@ -29,6 +29,33 @@ TinkerPop 3.2.3 Please see the link:https://github.com/apache/tinkerpop/blob/3.2.3/CHANGELOG.asciidoc#release-3-2-3[changelog] for a complete list of all the modifications that are part of this release. +Upgrading for Users +~~~~~~~~~~~~~~~~~~~ + +Where Step Supports By-Modulation +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +It is now possible to use `by()` with `where()` predicate-based steps. Previously, without using `match()`, if you wanted +to know who was older than their friend, the following traversal would be used. + +[source,text] +---- +gremlin> g.V().as('a').out('knows').as('b'). +......1> filter(select('a','b').by('age').where('a', lt('b'))) +==>v[4] +---- + +Now, with `where().by()` support, the above traversal can be expressed more succinctly and more naturally as follows. + +[source,text] +---- +gremlin> g.V().as('a').out('knows').as('b'). +......1> where('a', lt('b')).by('age') +==>v[4] +---- + +See: link:https://issues.apache.org/jira/browse/TINKERPOP-1330[TINKERPOP-1330] + TinkerPop 3.2.2 ---------------