Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id EA89B200B70 for ; Fri, 12 Aug 2016 14:40:20 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id E953C160AA6; Fri, 12 Aug 2016 12:40:20 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id 94360160AB9 for ; Fri, 12 Aug 2016 14:40:19 +0200 (CEST) Received: (qmail 98207 invoked by uid 500); 12 Aug 2016 12:40:18 -0000 Mailing-List: contact commits-help@tinkerpop.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@tinkerpop.apache.org Delivered-To: mailing list commits@tinkerpop.apache.org Received: (qmail 98154 invoked by uid 99); 12 Aug 2016 12:40:18 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 12 Aug 2016 12:40:18 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id 68E50E0B16; Fri, 12 Aug 2016 12:40:18 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: pluradj@apache.org To: commits@tinkerpop.apache.org Date: Fri, 12 Aug 2016 12:40:18 -0000 Message-Id: <3a6d6c94978d42d28122696dcf4613e6@git.apache.org> X-Mailer: ASF-Git Admin Mailer Subject: [01/11] tinkerpop git commit: minor word and link cleanup [Forced Update!] archived-at: Fri, 12 Aug 2016 12:40:21 -0000 Repository: tinkerpop Updated Branches: refs/heads/TINKERPOP-1379 db7526f47 -> 6d2939422 (forced update) minor word and link cleanup Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/a707a8db Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/a707a8db Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/a707a8db Branch: refs/heads/TINKERPOP-1379 Commit: a707a8db6088ba3df86fa056606b7365f0a3d2da Parents: 168097b Author: Robert Dale Authored: Sat Jul 16 19:41:52 2016 -0400 Committer: Robert Dale Committed: Wed Jul 27 14:20:19 2016 -0400 ---------------------------------------------------------------------- docs/src/dev/developer/contributing.asciidoc | 6 ++-- docs/src/dev/provider/index.asciidoc | 4 +-- .../src/reference/gremlin-applications.asciidoc | 4 +-- .../reference/implementations-neo4j.asciidoc | 12 ++++---- docs/src/reference/preface.asciidoc | 4 +-- docs/src/reference/the-graphcomputer.asciidoc | 2 +- docs/src/reference/the-traversal.asciidoc | 30 ++++++++++++++++++-- .../upgrade/release-3.1.x-incubating.asciidoc | 4 +-- 8 files changed, 46 insertions(+), 20 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/dev/developer/contributing.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/dev/developer/contributing.asciidoc b/docs/src/dev/developer/contributing.asciidoc index bcc2e04..456a055 100644 --- a/docs/src/dev/developer/contributing.asciidoc +++ b/docs/src/dev/developer/contributing.asciidoc @@ -62,7 +62,7 @@ Reviewing Changes Virtually all changes to TinkerPop's source code are performed via GitHub link:https://github.com/apache/tinkerpop/pulls[pull requests]. When a pull request is issue it undergoes a <> prior to be merged to a release branch. Anyone is free to comment and provide a vote (+1/+0/-1) -on a pull request. Note that votes of non-commiters are considered non-binding, but are certainly considered in the +on a pull request. Note that votes of non-committers are considered non-binding, but are certainly considered in the review process. Writing Documentation @@ -182,7 +182,7 @@ to easily track what that branch is for. .. Consider which branch to create the branch from in the first place. In other words, is the change to be targetted at a specific TinkerPop version (e.g. a patch to an older version)? When in doubt, please ask on dev@tinkerpop.apache.org. -. Bulid the project and run tests. +. Build the project and run tests. .. A simple build can be accomplished with maven: `mvn clean install`. .. Often, a "simple build" isn't sufficient and integration tests are required: `mvn clean install -DskipIntegrationTests=false -DincludeNeo4j`. Note that Hadoop must be running for the integration @@ -221,4 +221,4 @@ and resolving the conflicts by hand, then pushing the result to your branch. Or and force pushing the branch. . Try to be responsive to the discussion rather than let days pass between replies -On successful review, the *pull request will be merged* to the main repository and the JIRA issue will be closed. \ No newline at end of file +On successful review, the *pull request will be merged* to the main repository and the JIRA issue will be closed. http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/dev/provider/index.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/dev/provider/index.asciidoc b/docs/src/dev/provider/index.asciidoc index 7b876a1..9a07245 100644 --- a/docs/src/dev/provider/index.asciidoc +++ b/docs/src/dev/provider/index.asciidoc @@ -147,7 +147,7 @@ Implementing MapReduce Emitters +++++++++++++++++++++++++++++++ image:hadoop-logo-notext.png[width=150,float=left] The MapReduce framework in TinkerPop3 is similar to the model -popularized by link:http://apache.hadoop.org[Hadoop]. The primary difference is that all Mappers process the vertices +popularized by link:http://hadoop.apache.org[Hadoop]. The primary difference is that all Mappers process the vertices of the graph, not an arbitrary key/value pair. However, the vertices' edges can not be accessed -- only their properties. This greatly reduces the amount of data needed to be pushed through the MapReduce engine as any edge information required, can be computed in the VertexProgram.execute() method. Moreover, at this stage, vertices can @@ -964,4 +964,4 @@ Console plugin host. Simply instantiate and return a `RemoteAcceptor` in the `G of the plugin implementation. Generally speaking, each call to `remoteAcceptor()` should produce a new instance of a `RemoteAcceptor`. It will likely be necessary that you provide context from the `GremlinPlugin` to the `RemoteAcceptor` plugin. For example, the `RemoteAcceptor` implementation might require an instance of `Groovysh` -to provide a way to dynamically evaluate a script provided to it so that it can process the results in a different way. \ No newline at end of file +to provide a way to dynamically evaluate a script provided to it so that it can process the results in a different way. http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/reference/gremlin-applications.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/reference/gremlin-applications.asciidoc b/docs/src/reference/gremlin-applications.asciidoc index 488663f..9f5121f 100644 --- a/docs/src/reference/gremlin-applications.asciidoc +++ b/docs/src/reference/gremlin-applications.asciidoc @@ -697,7 +697,7 @@ WebSockets-based connection, it can also be configured to support link:http://en The REST endpoint provides for a communication protocol familiar to most developers, with a wide support of programming languages, tools and libraries for accessing it. As a result, REST provides a fast way to get started with Gremlin Server. It also may represent an easier upgrade path from link:http://rexster.tinkerpop.com/[Rexster] -as the API for the endpoint is very similar to Rexster's link:https://github.org/apache/tinkerpop/rexster/wiki/Gremlin-Extension[Gremlin Extension]. +as the API for the endpoint is very similar to Rexster's link:https://github.com/tinkerpop/rexster/wiki/Gremlin-Extension[Gremlin Extension]. Gremlin Server provides for a single REST endpoint - a Gremlin evaluator - which allows the submission of a Gremlin script as a request. For each request, it returns a response containing the serialized results of that script. @@ -1446,7 +1446,7 @@ Display stack trace? [yN] n ---- The same behavior would be seen with REST or when using sessionless requests through one of the Gremlin Server drivers. -If having this behavior is desireable, then <>. +If having this behavior is desireable, then <>. There is an exception to this notion of state not existing between requests and that is globally defined functions. All functions created via scripts are global to the server. http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/reference/implementations-neo4j.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/reference/implementations-neo4j.asciidoc b/docs/src/reference/implementations-neo4j.asciidoc index d1fc30b..8c63925 100644 --- a/docs/src/reference/implementations-neo4j.asciidoc +++ b/docs/src/reference/implementations-neo4j.asciidoc @@ -33,7 +33,7 @@ Neo4j-Gremlin ---- -link:http://neotechnology.com[Neo Technology] are the developers of the OLTP-based link:http://neo4j.org[Neo4j graph database]. +link:http://neo4j.com[Neo Technology] are the developers of the OLTP-based link:http://neo4j.com[Neo4j graph database]. WARNING: Unless under a commercial agreement with Neo Technology, Neo4j is licensed link:http://en.wikipedia.org/wiki/Affero_General_Public_License[AGPL]. The `neo4j-gremlin` module is licensed Apache2 @@ -69,8 +69,8 @@ NOTE: `Neo4jGraphStep` will attempt to discern which indices to use when executi The Gremlin-Console session below demonstrates Neo4j indices. For more information, please refer to the Neo4j documentation: -* Manipulating indices with link:http://docs.neo4j.org/chunked/stable/query-schema-index.html[Cypher]. -* Manipulating indices with the Neo4j link:http://docs.neo4j.org/chunked/stable/tutorials-java-embedded-new-index.html[Java API]. +* Manipulating indices with link:http://neo4j.com/docs/developer-manual/current/#query-schema-index[Cypher]. +* Manipulating indices with the Neo4j link:http://neo4j.com/docs/stable/tutorials-java-embedded-new-index.html[Java API]. [gremlin-groovy] ---- @@ -116,7 +116,7 @@ graph.close() Multi/Meta-Properties ~~~~~~~~~~~~~~~~~~~~~ -`Neo4jGraph` supports both multi- and meta-properties (see <<_vertex_properties,vertex properties>>). These features +`Neo4jGraph` supports both multi- and meta-properties (see <>). These features are not native to Neo4j and are implemented using "hidden" Neo4j nodes. For example, when a vertex has multiple "name" properties, each property is a new node (multi-properties) which can have properties attached to it (meta-properties). As such, the native, underlying representation may become difficult to query directly using @@ -156,7 +156,7 @@ Cypher image::gremlin-loves-cypher.png[width=400] -NeoTechnology are the creators of the graph pattern-match query language link:http://www.neo4j.org/learn/cypher[Cypher]. +NeoTechnology are the creators of the graph pattern-match query language link:https://neo4j.com/developer/cypher-query-language/[Cypher]. It is possible to leverage Cypher from within Gremlin by using the `Neo4jGraph.cypher()` graph traversal method. [gremlin-groovy] @@ -179,7 +179,7 @@ Multi-Label TinkerPop3 requires every `Element` to have a single, immutable string label (i.e. a `Vertex`, `Edge`, and `VertexProperty`). In Neo4j, a `Node` (vertex) can have an -link:http://neo4j.com/docs/stable/graphdb-neo4j-labels.html[arbitrary number of labels] while a `Relationship` +link:http://neo4j.com/docs/developer-manual/current/#graphdb-neo4j-labels[arbitrary number of labels] while a `Relationship` (edge) can have one and only one. Furthermore, in Neo4j, `Node` labels are mutable while `Relationship` labels are not. In order to handle this mismatch, three `Neo4jVertex` specific methods exist in Neo4j-Gremlin. http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/reference/preface.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/reference/preface.asciidoc b/docs/src/reference/preface.asciidoc index 142f935..6ee6e8b 100644 --- a/docs/src/reference/preface.asciidoc +++ b/docs/src/reference/preface.asciidoc @@ -56,7 +56,7 @@ Gremlin responded: The machines wondered: - "If what is is the TinkerPop, then perhaps we are The TinkerPop and our realization is simply the realization of + "If what this is is the TinkerPop, then perhaps we are The TinkerPop and our realization is simply the realization of the TinkerPop?" Would the machines, by their very nature of realizing The TinkerPop, be The TinkerPop? Or, on the same side of the @@ -94,4 +94,4 @@ image::gremlintron.png[width=400] NOTE: TinkerPop2 and below made a sharp distinction between the various TinkerPop projects: Blueprints, Pipes, Gremlin, Frames, Furnace, and Rexster. With TinkerPop3, all of these projects have been merged and are generally known as Gremlin. *Blueprints* -> Gremlin Structure API : *Pipes* -> `GraphTraversal` : *Frames* -> `Traversal` : -*Furnace* -> `GraphComputer` and `VertexProgram` : *Rexster* -> GremlinServer. \ No newline at end of file +*Furnace* -> `GraphComputer` and `VertexProgram` : *Rexster* -> GremlinServer. http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/reference/the-graphcomputer.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/reference/the-graphcomputer.asciidoc b/docs/src/reference/the-graphcomputer.asciidoc index f9116fb..453b62e 100644 --- a/docs/src/reference/the-graphcomputer.asciidoc +++ b/docs/src/reference/the-graphcomputer.asciidoc @@ -74,7 +74,7 @@ image::graphcomputer.png[width=500] The example below demonstrates how to submit a VertexProgram to a graph's GraphComputer. `GraphComputer.submit()` yields a `Future`. The `ComputerResult` has the resultant computed graph which can be a full copy of the original graph (see <>) or a view over the original graph (see -<>). The ComputerResult also provides access to computational side-effects called `Memory` +<>). The ComputerResult also provides access to computational side-effects called `Memory` (which includes, for example, runtime, number of iterations, results of MapReduce jobs, and VertexProgram-specific memory manipulations). http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/reference/the-traversal.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc index ca4c6be..e897810 100644 --- a/docs/src/reference/the-traversal.asciidoc +++ b/docs/src/reference/the-traversal.asciidoc @@ -205,7 +205,7 @@ g.V(1).property('friendWeight',outE('knows').values('weight').sum(),'acl','priva g.V(1).properties('friendWeight').valueMap() <3> ---- -<1> For vertices, a cardinality can be provided for <>. +<1> For vertices, a cardinality can be provided for <>. <2> It is possible to select the property value (as well as key) via a traversal. <3> For vertices, the `property()`-step can add meta-properties. @@ -376,7 +376,7 @@ g.V().group().by(bothE().count()).by(count()) <3> <2> `by('name')` will process the grouped elements by their name (*element property projection*). <3> `by(count())` will count the number of elements in each group (*traversal*). -[cap-step]] +[[cap-step]] Cap Step ~~~~~~~~ @@ -1127,6 +1127,12 @@ g.V().repeat(both()).times(3).values('age').min() IMPORTANT: `min(local)` determines the min of the current, local object (not the objects in the traversal stream). This works for `Collection` and `Number`-type objects. For any other object, a min of `Double.NaN` is returned. +[[option-step]] +Option Step +~~~~~~~~~~~~~ + +An option to a <> or <> + [[or-step]] Or Step ~~~~~~~ @@ -1286,6 +1292,26 @@ path.c path.d == path.e ---- +<<<<<<< HEAD +======= +[[peerpressure-step]] +PeerPressure Step +~~~~~~~~~~~~~~~~~ + +The `peerPressure()`-step (*map*/*sideEffect*) clusters vertices using <>. + +IMPORTANT: The `peerPressure()`-step is a `VertexComputing`-step and as such, can only be used against a graph that supports `GraphComputer` (OLAP). + +[gremlin-groovy,modern] +---- +g = graph.traversal().withComputer() +g.V().peerPressure().by('cluster').values('cluster') +g.V().hasLabel('person'). + peerPressure().by('cluster'). + group().by('cluster').by('name') +---- + +>>>>>>> deb99f6... minor word and link cleanup [[profile-step]] Profile Step ~~~~~~~~~~~~ http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/a707a8db/docs/src/upgrade/release-3.1.x-incubating.asciidoc ---------------------------------------------------------------------- diff --git a/docs/src/upgrade/release-3.1.x-incubating.asciidoc b/docs/src/upgrade/release-3.1.x-incubating.asciidoc index 1ed3ed4..11cdb32 100644 --- a/docs/src/upgrade/release-3.1.x-incubating.asciidoc +++ b/docs/src/upgrade/release-3.1.x-incubating.asciidoc @@ -324,7 +324,7 @@ backward compatible with previous versions) will become the future standard mode it provides a more efficient method for transaction management. See: link:https://issues.apache.org/jira/browse/TINKERPOP-930[TINKERPOP-930], -link:http://tinkerpop.apache.org/docs/3.1.1-incubating/#considering-transactions[Reference Documentation - Considering Transactions] +link:http://tinkerpop.apache.org/docs/3.1.1-incubating/reference/#considering-transactions[Reference Documentation - Considering Transactions] Deprecated credentialsDbLocation ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -343,7 +343,7 @@ the `gremlin.tinkergraph.graphLocation` as soon as possible, as the deprecated s release. See: link:https://issues.apache.org/jira/browse/TINKERPOP-981[TINKERPOP-981], -link:http://tinkerpop.apache.org/docs/3.1.1-incubating/#_security[Reference Documentation - Gremlin Server Security] +link:http://tinkerpop.apache.org/docs/3.1.1-incubating/reference/#_security[Reference Documentation - Gremlin Server Security] TinkerGraph Supports Any I/O ^^^^^^^^^^^^^^^^^^^^^^^^^^^^