Added a note about plugins in upgrade docs CTR
Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/22276a8d Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/22276a8d Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/22276a8d Branch: refs/heads/TINKERPOP-1742-master Commit: 22276a8d244e0e0c502aa037b9f22ecddc02b687 Parents: b4224fb Author: Stephen Mallette <sp...@genoprime.com> Authored: Fri Aug 11 07:43:34 2017 -0400 Committer: Stephen Mallette <sp...@genoprime.com> Committed: Fri Aug 11 07:43:34 2017 -0400 ---------------------------------------------------------------------- docs/src/upgrade/release-3.3.x.asciidoc | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/22276a8d/docs/src/upgrade/release-3.3.x.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/upgrade/release-3.3.x.asciidoc b/docs/src/upgrade/release-3.3.x.asciidoc index 41c41c0..21137f1 100644 --- a/docs/src/upgrade/release-3.3.x.asciidoc +++ b/docs/src/upgrade/release-3.3.x.asciidoc @@ -479,6 +479,25 @@ See: link:https://issues.apache.org/jira/browse/TINKERPOP-1389 Upgrading for Providers ~~~~~~~~~~~~~~~~~~~~~~~ +IMPORTANT: It is recommended that providers also review all the upgrade instructions specified for users. Many of the +changes there may prove important for the provider's implementation. + +Graph System Providers +^^^^^^^^^^^^^^^^^^^^^^ + +GremlnPlugin +++++++++++++ + +The previously deprecated `GremlinPlugin` system has been removed. The old `GremlinPlugin` interface formerly resided +in the `org.apache.tinkerpop.gremlin.groovy.plugin` package of `gremlin-groovy`. This interface was replaced by an +interface of the same name in 3.2.4, which now resides in the `org.apache.tinkerpop.gremlin.jsr223` package in +`gremlin-core`. Obviously, existing plugins will need to be updated to use this new interface. + +The plugin model has changed slightly to be more generic and not specifically bound to Groovy based script engines. +Under the new model, the plugin simply returns `Customizer` instances that can be applied generically to any +`ScriptEngine` or specifically to a particular `ScriptEngine`. More details can be found in the +link:http://tinkerpop.apache.org/docs/x.y.z/dev/provider/#gremlin-plugins[Provider Documentation] + Graph Database Providers ^^^^^^^^^^^^^^^^^^^^^^^^