TINKERPOP-786 Updated upgrade docs with DSL info
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/869ba9a4 Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/869ba9a4 Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/869ba9a4 Branch: refs/heads/tp32-glv Commit: 869ba9a45ee8ef897e40fa65d61ce1ac4598bea5 Parents: db9343f Author: Stephen Mallette <[email protected]> Authored: Wed May 24 05:10:22 2017 -0400 Committer: Stephen Mallette <[email protected]> Committed: Wed May 24 05:10:22 2017 -0400 ---------------------------------------------------------------------- .../upgrade/release-3.2.x-incubating.asciidoc | 25 ++++++++++++++++++-- 1 file changed, 23 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/869ba9a4/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 a2045e4..eeb193e 100644 --- a/docs/src/upgrade/release-3.2.x-incubating.asciidoc +++ b/docs/src/upgrade/release-3.2.x-incubating.asciidoc @@ -32,6 +32,27 @@ Please see the link:https://github.com/apache/tinkerpop/blob/3.2.5/CHANGELOG.asc Upgrading for Users ~~~~~~~~~~~~~~~~~~~ +DSL Support +^^^^^^^^^^^ + +It has always been possible to construct Domain Specific Languages (DSLs) with Gremlin, but the approach has required +a somewhat deep understanding of the TinkerPop code base and it is not something that has had a recommeded method +for implementation. With this release, TinkerPop simplifies DSL development and provides the best practices for their +implementation. + +[source,java] +---- +// standard Gremlin +g.V().hasLabel('person'). + where(outE("created").count().is(P.gte(2))).count() + +// the same traversal as above written as a DSL +social.persons().where(createdAtLeast(2)).count() +---- + +See: link:https://issues.apache.org/jira/browse/TINKERPOP-786[TINKERPOP-786], +link:http://tinkerpop.apache.org/docs/3.2.5/dev/reference/#dsl[Reference Documentation] + Authentication Configuration ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -40,7 +61,7 @@ authentication handler and channelizer classes to use. This has been deprecated A class that extends `AbstractAuthenticationHandler` may also now be provided as `authentication.authenticationHandler` to be used in either of the provided channelizer classes to handle the provided authenticator -See: https://issues.apache.org/jira/browse/TINKERPOP-1657[TINKERPOP-1657] +See: link:https://issues.apache.org/jira/browse/TINKERPOP-1657[TINKERPOP-1657] Default Maximum Parameters ^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -72,7 +93,7 @@ be helpful in understanding usage problems. As `GremlinScriptEngine` instances a are naturally exposed as part of the standard link:http://tinkerpop.apache.org/docs/current/reference/#_metrics[metrics] set. Note that metrics are captured for both sessionless requests as well as for each individual session that is opened. -See: https://issues.apache.org/jira/browse/TINKERPOP-1644[TINKERPOP-1644] +See: link:https://issues.apache.org/jira/browse/TINKERPOP-1644[TINKERPOP-1644] Additional Error Information ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
