You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tinkerpop.apache.org by sp...@apache.org on 2018/02/02 19:32:09 UTC

[1/4] tinkerpop git commit: Added links to javadoc on all steps in reference docs CTR

Repository: tinkerpop
Updated Branches:
  refs/heads/master b86b183a6 -> 6c38c50b2


Added links to javadoc on all steps in reference docs CTR


Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/df3d6d7c
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/df3d6d7c
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/df3d6d7c

Branch: refs/heads/master
Commit: df3d6d7c4f470e6f4a076624f122ac9ca0987550
Parents: 0f58b7c
Author: Stephen Mallette <sp...@genoprime.com>
Authored: Fri Feb 2 14:02:49 2018 -0500
Committer: Stephen Mallette <sp...@genoprime.com>
Committed: Fri Feb 2 14:02:49 2018 -0500

----------------------------------------------------------------------
 docs/src/reference/the-traversal.asciidoc | 409 ++++++++++++++++++++++++-
 1 file changed, 399 insertions(+), 10 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/df3d6d7c/docs/src/reference/the-traversal.asciidoc
----------------------------------------------------------------------
diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc
index 741cda2..a7b1e29 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -211,6 +211,10 @@ g.E(23).valueMap()
 <5> Two arbitrary bindings in a traversal can be joined `from()`->`to()`, where `id` can be provided for graphs that
 supports user provided ids.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addEdge(String)`]
+
 [[addvertex-step]]
 === AddVertex Step
 
@@ -226,6 +230,11 @@ g.V().has('name','nothing')
 g.V().has('name','nothing').bothE()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV--[`addV()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-java.lang.String-[`addV(String)`])
+
 [[addproperty-step]]
 === AddProperty Step
 
@@ -248,6 +257,11 @@ g.V(1).properties('friendWeight').valueMap() <3>
 <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.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#property-java.lang.Object-java.lang.Object-java.lang.Object...-[`property(Object, Object, Object...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#property-org.apache.tinkerpop.gremlin.structure.VertexProperty.Cardinality-java.lang.Object-java.lang.Object-java.lang.Object...-[`property(Cardinality, Object, Object, Object...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/VertexProperty.Cardinality.html[`Cardinality`]
 
 [[aggregate-step]]
 === Aggregate Step
@@ -288,6 +302,10 @@ g.V().out('knows').aggregate('x').cap('x')
 g.V().out('knows').aggregate('x').by('name').cap('x')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#aggregate-java.lang.String-[`aggregate(String)`]
+
 [[and-step]]
 === And Step
 
@@ -312,6 +330,10 @@ only two traversals can be and'd together.
 g.V().where(outE('created').and().outE('knows')).values('name')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#and-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`and(Traversal...)`]
+
 [[as-step]]
 === As Step
 
@@ -339,6 +361,10 @@ g.V().hasLabel('software').as('a','b','c').
      by(__.in('created').values('name').fold())
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#as-java.lang.String-java.lang.String...-[`as(String...)`]
+
 [[barrier-step]]
 === Barrier Step
 
@@ -393,6 +419,12 @@ g.V().both().both().both().count().iterate().toString()  <2>
 <1> `LazyBarrierStrategy` is a default strategy and thus, does not need to be explicitly activated.
 <1> With `LazyBarrierStrategy` activated, `barrier()` steps are automatically inserted where appropriate.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#barrier--[`barrier()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#barrier-java.util.function.Consumer-[`barrier(Consumer)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#barrier-int-[`barrier(int)`]
+
 [[by-step]]
 === By Step
 
@@ -430,6 +462,22 @@ on a step-by-step level and thus, as discussed in their respective section of th
 * <<aggregate-step, `aggregate()`>>: aggregate all objects into a set but only store their `by()`-modulated values.
 * <<store-step, `store()`>>: store all objects into a set but only store their `by()`-modulated values.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by--[`by()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-java.util.Comparator-[`by(Comparator)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-java.util.function.Function-java.util.Comparator-[`by(Function,Comparator)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-java.util.function.Function-[`by(Function)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-org.apache.tinkerpop.gremlin.process.traversal.Order-[`by(Order)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-java.lang.String-[`by(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-java.lang.String-java.util.Comparator-[`by(String,Comparator)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-org.apache.tinkerpop.gremlin.structure.T-[`by(T)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`by(Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#by-org.apache.tinkerpop.gremlin.process.traversal.Traversal-java.util.Comparator-[`by(Traversal,Comparator)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/T.html[`T`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Order.html[`Order`]
+
+
 [[cap-step]]
 === Cap Step
 
@@ -445,6 +493,10 @@ g.V().groupCount('a').by(label).groupCount('b').by(outE().count()).cap('a','b')
 <1> Group and count vertices by their label.  Emit the side effect labeled 'a', which is the group count by label.
 <2> Same as statement 1, but also emit the side effect labeled 'b' which groups vertices by the number of out edges.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#cap-java.lang.String-java.lang.String...-[`cap(String,String...)`]
+
 [[choose-step]]
 === Choose Step
 
@@ -501,6 +553,15 @@ g.V().hasLabel('person').
         option(none, values('name'))
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-java.util.function.Function-[`choose(Function)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-java.util.function.Predicate-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`choose(Predicate,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-java.util.function.Predicate-org.apache.tinkerpop.gremlin.process.traversal.Traversal-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`choose(Predicate,Traversal,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-org.apache.tinkerpop.gremlin.process.traversal.Traversal-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`choose(Traversal,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-org.apache.tinkerpop.gremlin.process.traversal.Traversal-org.apache.tinkerpop.gremlin.process.traversal.Traversal-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`choose(Traversal,Traversal,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#choose-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`choose(Traversal)`]
+
 [[coalesce-step]]
 === Coalesce Step
 
@@ -515,6 +576,10 @@ g.V(1).property('nickname', 'okram')
 g.V().hasLabel('person').coalesce(values('nickname'), values('name'))
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coalesce-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`coalesce(Traversal)`]
+
 [[coin-step]]
 === Coin Step
 
@@ -527,6 +592,10 @@ g.V().coin(0.0)
 g.V().coin(1.0)
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coin-double-[`coin(double)`]
+
 [[constant-step]]
 === Constant Step
 
@@ -546,6 +615,10 @@ g.V().coalesce(
 <1> Show the names of people, but show "inhuman" for other vertices.
 <2> Same as statement 1 (unless there is a person vertex with no name).
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#constant-E2-[`constant(Object)`]
+
 [[count-step]]
 === Count Step
 
@@ -567,6 +640,12 @@ g.V().hasLabel('person').outE('created').count().map {it.get() * 10}.path() <2>
 IMPORTANT: `count(local)` counts the current, local object (not the objects in the traversal stream). This works for
 `Collection`- and `Map`-type objects. For any other object, a count of 1 is returned.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#count--[`count()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#count-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`count(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[cyclicpath-step]]
 === CyclicPath Step
 
@@ -592,6 +671,10 @@ g.V(1).as('a').out('created').as('b').
   path()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#cyclicPath--[`cyclicPath()`]
+
 [[dedup-step]]
 === Dedup Step
 
@@ -627,6 +710,12 @@ g.V().as('a').out('created').as('b').in('created').as('c').dedup('a','b').select
 
 <1> If the current `a` and `b` combination has been seen previously, then filter the traverser.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dedup-org.apache.tinkerpop.gremlin.process.traversal.Scope-java.lang.String...-[`dedup(Scope,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dedup-java.lang.String...-[`dedup(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[drop-step]]
 === Drop Step
 
@@ -643,12 +732,22 @@ g.V().drop()
 g.V()
 ----
 
+*Additional References*
+
+* link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#drop--[`drop()`]
+
 [[emit-step]]
 === Emit Step
 
 The `emit`-step is not an actual step, but is instead a step modulator for `<<repeat-step,repeat()>>` (find more
 documentation on the `emit()` there).
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#emit--[`emit()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#emit-java.util.function.Predicate-[`emit(Predicate)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#emit-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`emit(Traversal)`]
+
 [[explain-step]]
 === Explain Step
 
@@ -691,6 +790,11 @@ g.V().values('age').sum() <6>
 <5> The same as before, but using a built-in bi-function.
 <6> The same as before, but using the <<sum-step,`sum()`-step>>.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold--[`fold()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold-E2-java.util.function.BiFunction-[`fold(Object,BiFunction)`]
+
 [[graph-step]]
 === Graph Step
 
@@ -715,6 +819,10 @@ g.V().has('name', within('marko', 'vadas', 'josh')).as('person').
 <1> Normally the `V()`-step will iterate over all vertices. However, graph strategies can fold `HasContainer`'s into a `GraphStep` to allow index lookups.
 <2> Whether the graph system provider supports mid-traversal `V()` index lookups or not can easily be determined by inspecting the `toString()` output of the iterated traversal. If `has` conditions were folded into the `V()`-step, an index - if one exists - will be used.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#V-java.lang.Object...-[`V(Object...)`]
+
 [[from-step]]
 === From Step
 
@@ -725,6 +833,11 @@ means by which they are added. The general pattern is `step().from()`. See <<to-
 The list of steps that support `from()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
  <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-java.lang.String-[`from(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`]
+
 [[group-step]]
 === Group Step
 
@@ -750,6 +863,11 @@ The two projection parameters available to `group()` via `by()` are:
 . Key-projection: What feature of the object to group on (a function that yields the map key)?
 . Value-projection: What feature of the group to store in the key-list?
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#group--[`group()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#group-java.lang.String-[`group(String)`]
+
 [[groupcount-step]]
 === GroupCount Step
 
@@ -782,6 +900,11 @@ The above is interesting in that it demonstrates the use of referencing the inte
 `groupCount()` with a string variable. Given that `groupCount()` is a sideEffect-step, it simply passes the object
 it received to its output. Internal to `groupCount()`, the object's count is incremented.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#groupCount--[`groupCount()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#groupCount-java.lang.String-[`groupCount(String)`]
+
 [[has-step]]
 === Has Step
 
@@ -828,6 +951,29 @@ the key,value pairs for those vertices.
 TinkerPop does not support a regular expression predicate, although specific graph databases that leverage TinkerPop
 may provide a partial match extension.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-[`has(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-java.lang.Object-[`has(String,Object)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-org.apache.tinkerpop.gremlin.process.traversal.P-[`has(String,P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-java.lang.String-java.lang.Object-[`has(String,String,Object)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-java.lang.String-org.apache.tinkerpop.gremlin.process.traversal.P-[`has(String,String,P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-java.lang.String-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`has(String,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-org.apache.tinkerpop.gremlin.structure.T-java.lang.Object-[`has(T,Object)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-org.apache.tinkerpop.gremlin.structure.T-org.apache.tinkerpop.gremlin.process.traversal.P-[`has(T,P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#has-org.apache.tinkerpop.gremlin.structure.T-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`has(T,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasId-java.lang.Object-java.lang.Object...-[`hasId(Object,Object...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasId-org.apache.tinkerpop.gremlin.process.traversal.P-[`hasId(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasKey-org.apache.tinkerpop.gremlin.process.traversal.P-[`hasKey(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasKey-java.lang.String-java.lang.String...-[`hasKey(String,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasLabel-org.apache.tinkerpop.gremlin.process.traversal.P-[`hasLabel(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasLabel-java.lang.String-java.lang.String...-[`hasLabel(String,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasNot-java.lang.String-[`hasNot(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasValue-java.lang.Object-java.lang.Object...-[`hasValue(Object,Object...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#hasValue-org.apache.tinkerpop.gremlin.process.traversal.P-[`hasValue(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/P.html[`P`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/T.html[`T`]
+
 [[id-step]]
 === Id Step
 
@@ -841,6 +987,25 @@ g.V(1).outE().id()
 g.V(1).properties().id()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#id--[`id()`]
+
+[[identity-step]]
+=== Identity Step
+
+The `identity()`-step (*map*) is an link:https://en.wikipedia.org/wiki/Identity_function[identity function] which maps
+the current object to itself.
+
+[gremlin-groovy,modern]
+----
+g.V().identity()
+----
+
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#identity--[`identity()`]
+
 [[inject-step]]
 === Inject Step
 
@@ -867,6 +1032,10 @@ inject(1,2).map {it.get() + 1}
 inject(1,2).map {it.get() + 1}.map {g.V(it.get()).next()}.values('name')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#inject-E...-[`inject(Object)`]
+
 [[is-step]]
 === Is Step
 
@@ -887,6 +1056,27 @@ g.V().where(__.in('created').values('age').
 <2> Find projects having two or more contributors.
 <3> Find projects whose contributors average age is between 30 and 35.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#is-java.lang.Object-[`is(Object)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#is-org.apache.tinkerpop.gremlin.process.traversal.P-[`is(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/P.html[`P`]  
+
+[[key-step]]
+=== Key Step
+
+The `key()`-step (*map*) takes a `Property` and extracts the key from it.
+
+[gremlin-groovy,theCrew]
+----
+g.V(1).properties().key()
+g.V(1).properties().properties().key()
+----
+
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#key--[`key()`]
+
 [[label-step]]
 === Label Step
 
@@ -899,16 +1089,9 @@ g.V(1).outE().label()
 g.V(1).properties().label()
 ----
 
-[[key-step]]
-=== Key Step
-
-The `key()`-step (*map*) takes a `Property` and extracts the key from it.
+*Additional References*
 
-[gremlin-groovy,theCrew]
-----
-g.V(1).properties().key()
-g.V(1).properties().properties().key()
-----
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#label--[`label()`]
 
 [[limit-step]]
 === Limit Step
@@ -934,6 +1117,12 @@ g.V().valueMap().limit(local, 1) <2>
 <1> `List<String>` for each vertex containing the first two locations.
 <2> `Map<String, Object>` for each vertex, but containing only the first property value.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#limit-long-[`limit(long)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#limit-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[`limit(Scope,long)`]
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[local-step]]
 === Local Step
 
@@ -975,6 +1164,10 @@ WARNING: The anonymous traversal of `local()` processes the current object "loca
 of computing is the vertex and its local "star graph," it is important that the anonymous traversal does not leave
 the confines of the vertex's star graph. In other words, it can not traverse to an adjacent vertex's properties or edges.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#local-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`local(Traversal)`]
+
 [[loops-step]]
 === Loops Step
 
@@ -985,6 +1178,10 @@ The `loops()`-step (*map*) extracts the number of times the `Traverser` has gone
 g.V().emit(__.has("name", "marko").or().loops().is(2)).repeat(__.out()).values("name")
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#loops--[`loops()`]
+
 [[match-step]]
 === Match Step
 
@@ -1207,6 +1404,10 @@ system to leverage the filter for index lookups.
 IMPORTANT: A `where()`-step is a filter and thus, variables within a `where()` clause are not globally bound to the
 path of the traverser in `match()`. As such, `where()`-steps in `match()` are used for filtering, not binding.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#match-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`match(Traversal...)`]
+
 [[max-step]]
 === Max Step
 
@@ -1221,6 +1422,12 @@ g.V().repeat(both()).times(3).values('age').max()
 IMPORTANT: `max(local)` determines the max 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 max of `Double.NaN` is returned.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#max--[`max()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#max-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`max(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[mean-step]]
 === Mean Step
 
@@ -1239,6 +1446,12 @@ thus altering the average.
 IMPORTANT: `mean(local)` determines the mean 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 mean of `Double.NaN` is returned.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#mean--[`mean()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#mean-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`mean(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[min-step]]
 === Min Step
 
@@ -1253,6 +1466,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.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#min--[`min()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#min-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`min(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[not-step]]
 === Not Step
 
@@ -1267,12 +1486,21 @@ g.V().hasLabel('person').
 ----
 
 <1> josh created two projects and vadas none
+ 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#not-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`not(Traversal)`]
 
 [[option-step]]
 === Option Step
 
 An option to a <<general-steps,`branch()`>> or <<choose-step,`choose()`>>.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#option-M-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`option(Object,Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#option-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`option(Traversal)`]
+
 [[optional-step]]
 === Optional Step
 
@@ -1297,6 +1525,10 @@ g.V().hasLabel('person').optional(out("knows").optional(out("created"))).path()
 
 <1> Returns the paths of everybody followed by who they know followed by what they created.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#optional-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`optional(Traversal)`]
+
 [[or-step]]
 === Or Step
 
@@ -1322,6 +1554,10 @@ only two traversals can be or'd together.
 g.V().where(outE('created').or().outE('knows')).values('name')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#or-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`or(Traversal...)`]
+
 [[order-step]]
 === Order Step
 
@@ -1383,6 +1619,12 @@ g.V().groupCount().by(inE().count()).order(local).by(keys, incr) <4>
 
 NOTE: The `values` and `keys` enums are from `Column` which is used to select "columns" from a `Map`, `Map.Entry`, or `Path`.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#order--[`order()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#order-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`order(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[pagerank-step]]
 === PageRank Step
 
@@ -1413,6 +1655,11 @@ g.V().hasLabel('person').
   order().by('friendRank',decr).valueMap('name','friendRank').explain()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#pageRank--[`pageRank()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#pageRank-double-[`pageRank(double)`]
+
 [[path-step]]
 === Path Step
 
@@ -1480,7 +1727,11 @@ path.a
 path.b
 path.c
 path.d == path.e
-----
+----   
+
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#path--[`path()`]
 
 [[peerpressure-step]]
 === PeerPressure Step
@@ -1498,6 +1749,10 @@ g.V().hasLabel('person').
   group().by('cluster').by('name')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#peerPressure--[`peerPressure()`]
+
 [[profile-step]]
 === Profile Step
 
@@ -1538,6 +1793,11 @@ metrics = t.getSideEffects().get('metrics')
 
 For traversal compilation information, please see <<explain-step,`explain()`>>-step.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#profile--[`profile()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#profile-java.lang.String-[`profile(String)`]
+
 [[project-step]]
 === Project Step
 
@@ -1559,6 +1819,10 @@ g.V().has('name','marko').
                  by(inE().count())
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#project-java.lang.String-java.lang.String...-[`project(String,String...)`]
+
 [[program-step]]
 === Program Step
 
@@ -1666,6 +1930,10 @@ g.V(1).properties('location').valueMap()
 g.V(1).properties('location').has('endTime').valueMap()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#properties-java.lang.String...-[`properties(String...)`]
+
 [[propertymap-step]]
 === PropertyMap Step
 
@@ -1679,6 +1947,10 @@ g.V().propertyMap('age','blah')
 g.E().propertyMap()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#propertyMap-java.lang.String...-[`propertyMap(String...)`]
+
 [[range-step]]
 === Range Step
 
@@ -1713,6 +1985,12 @@ second and third location for each vertex.
 g.V().valueMap().select('location').range(local, 1, 3)
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#range-long-long-[`range(long,long)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#range-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-long-[`range(Scope,long,long)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[repeat-step]]
 === Repeat Step
 
@@ -1790,6 +2068,10 @@ In OLAP, where the atomic unit of computing is the vertex and its local "star gr
 anonymous traversals do not leave the confines of the vertex's star graph. In other words, they can not traverse to
 an adjacent vertex's properties or edges.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#repeat-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`repeat(Traversal)`]
+
 [[sack-step]]
 === Sack Step
 
@@ -1869,6 +2151,10 @@ g.withBulk(false).withSack(1.0f).V(1).local(outE('knows').barrier(normSack).inV(
 <7> There is now a single traverser with bulk of 2 and sack of 1.0 and thus, setting withBulk(false) yields the expected 1.0
 <8> Like 7, but without the sum operator
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sack--[`sack()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sack-java.util.function.BiFunction-[`sack(BiFunction)`]
 
 [[sample-step]]
 === Sample Step
@@ -1901,6 +2187,12 @@ g.V(1).repeat(local(
        )).times(10).path()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-int-[`sample(int)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sample-org.apache.tinkerpop.gremlin.process.traversal.Scope-int-[`sample(Scope,int)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[select-step]]
 === Select Step
 
@@ -2011,6 +2303,15 @@ ensure respective `a` and `b` strings are not the same.
 <3> The first `select()` projects a vertex binding set. A binding is filtered if `a` vertex equals `b` vertex. A
 binding is filtered if `a` doesn't know `b`. The second and final `select()` projects the name of the vertices.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#select-org.apache.tinkerpop.gremlin.structure.Column-[`select(Column)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#select-org.apache.tinkerpop.gremlin.process.traversal.Pop-java.lang.String-[`select(Pop,String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#select-java.lang.String-[`select(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#select-java.lang.String-java.lang.String-java.lang.String...-[`select(String,String,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Column.html[`Column`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Pop.html[`Pop`]
+
 [[simplepath-step]]
 === SimplePath Step
 
@@ -2060,6 +2361,10 @@ g.V('A').as('a').
 <3> Traverse all acyclic 3-hop paths starting from vertex `A` and from there again all 3-hop paths. The second path may
 cross the vertices from the first path.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#simplePath--[`simplePath()`]
+
 [[store-step]]
 === Store Step
 
@@ -2082,6 +2387,10 @@ it passes through `store()` and thus, stored before filtered.
 g.E().store('x').by('weight').cap('x')
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#store-java.lang.String-[`store(String)`]
+
 [[subgraph-step]]
 === Subgraph Step
 
@@ -2127,6 +2436,10 @@ t.sideEffects.get('createdG').traversal().E()
 IMPORTANT: The `subgraph()`-step only writes to graphs that support user supplied ids for its elements. Moreover,
 if no graph is specified via `withSideEffect()`, then <<tinkergraph-gremlin,TinkerGraph>> is assumed.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#subgraph-java.lang.String-[`subgraph(String)`]
+
 [[sum-step]]
 === Sum Step
 
@@ -2143,6 +2456,12 @@ g.V().repeat(both()).times(3).values('age').sum()
 IMPORTANT: `sum(local)` determines the sum of the current, local object (not the objects in the traversal stream).
 This works for `Collection`-type objects. For any other object, a sum of `Double.NaN` is returned.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sum--[`sum()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sum-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`sum(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[tail-step]]
 === Tail Step
 
@@ -2178,6 +2497,13 @@ g.V().valueMap().tail(local) <4>
 <3> `List<String>` for each path containing the last two names from the 'a' step.
 <4> `Map<String, Object>` for each vertex, but containing only the last property value.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail--[`tail(long)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-long-[`tail(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[tail(Scope,long)`]
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+
 [[timelimit-step]]
 === TimeLimit Step
 
@@ -2205,6 +2531,10 @@ note that the internal clock of `timeLimit()`-step starts when the first travers
 reached, any `next()` evaluation of the step will yield a `NoSuchElementException` and any `hasNext()` evaluation will
 yield `false`.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#timeLimit-long-[`timeLimit(long)`]
+
 [[to-step]]
 === To Step
 
@@ -2214,6 +2544,15 @@ means by which they are added. The general pattern is `step().to()`. See <<from-
 
 The list of steps that support `to()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
  <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
+ 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Direction,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toE-org.apache.tinkerpop.gremlin.structure.Direction-java.lang.String...-[`toE(Direction,String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toV-org.apache.tinkerpop.gremlin.structure.Direction-[`toV(Direction)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Direction.html[`Direction`] 
 
 [[tree-step]]
 === Tree Step
@@ -2256,6 +2595,10 @@ g.V().has('name','josh').out('created').values('name').
 <1> When the `tree()` is created, vertex 3 and 5 are unique and thus, form unique branches in the tree structure.
 <2> When the `tree()` is `by()`-modulated by `label`, then vertex 3 and 5 are both "software" and thus are merged to a single node in the tree.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tree--[`tree()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tree-java.lang.String-[`tree(String)`]
 
 [[unfold-step]]
 === Unfold Step
@@ -2278,6 +2621,10 @@ inject(1,[2,3,[4,5,[6]]]).unfold()
 inject(1,[2,3,[4,5,[6]]]).repeat(unfold()).until(count(local).is(1)).unfold()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#unfold--[`unfold()`]
+
 [[union-step]]
 === Union Step
 
@@ -2297,12 +2644,21 @@ g.V(4).union(
          out().values('lang')).path()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#union-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`union(Traversal...)`]
+
 [[until-step]]
 === Until Step
 
 The `until`-step is not an actual step, but is instead a step modulator for `<<repeat-step,repeat()>>` (find more
 documentation on the `until()` there).
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#until-java.util.function.Predicate-[`until(Predicate)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#until-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`until(Traversal)`]
+
 [[value-step]]
 === Value Step
 
@@ -2314,6 +2670,10 @@ g.V(1).properties().value()
 g.V(1).properties().properties().value()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#value--[`value()`]
+
 [[valuemap-step]]
 === ValueMap Step
 
@@ -2349,6 +2709,11 @@ g.V().hasLabel('person').valueMap(true,'name')
 g.V().hasLabel('person').properties('location').valueMap(true)
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#valueMap-boolean-java.lang.String...-[`valueMap(boolean,String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#valueMap-java.lang.String...-[`valueMap(String...)`]
+
 [values-step]]
 === Values Step
 
@@ -2361,6 +2726,10 @@ g.V(1).values('location')
 g.V(1).properties('location').values()
 ----
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#values-java.lang.String...-[`values(String...)`]
+
 [[vertex-steps]]
 === Vertex Steps
 
@@ -2401,6 +2770,19 @@ g.V(4).inE().bothV()
 <4> Moving forward touching edges and vertices.
 <5> Moving forward only touching vertices.
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#both-java.lang.String...-[`both(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#bothE-java.lang.String...-[`bothE(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#bothV--[`bothV()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#in-java.lang.String...-[`in(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#inE-java.lang.String...-[`inE(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#inV--[`inV()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#otherV--[`otherV()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#out-java.lang.String...-[`out(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#outE-java.lang.String...-[`outE(String...)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#outV--[`outV()`]
+
 [[where-step]]
 === Where Step
 
@@ -2461,6 +2843,13 @@ the confines of the vertex's star graph. In other words, it can not traverse to
 edges. Note that is only a temporary limitation that will be addressed in a future version of TinkerPop3 (see
 link:https://issues.apache.org/jira/browse/TINKERPOP-693[TINKERPOP-693]).
 
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#where-org.apache.tinkerpop.gremlin.process.traversal.P-[`where(P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#where-java.lang.String-org.apache.tinkerpop.gremlin.process.traversal.P-[`where(String,P)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#where-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`where(Traversal)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/P.html[`P`]
+
 [[a-note-on-predicates]]
 == A Note on Predicates
 


[2/4] tinkerpop git commit: Merge branch 'tp32'

Posted by sp...@apache.org.
Merge branch 'tp32'

Conflicts:
	docs/src/reference/the-traversal.asciidoc


Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/abfa44fc
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/abfa44fc
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/abfa44fc

Branch: refs/heads/master
Commit: abfa44fced98d123e47203792c2f31d66e6734cf
Parents: b86b183 df3d6d7
Author: Stephen Mallette <sp...@genoprime.com>
Authored: Fri Feb 2 14:21:40 2018 -0500
Committer: Stephen Mallette <sp...@genoprime.com>
Committed: Fri Feb 2 14:21:40 2018 -0500

----------------------------------------------------------------------
 docs/src/reference/the-traversal.asciidoc | 422 ++++++++++++++++++++++++-
 1 file changed, 413 insertions(+), 9 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/abfa44fc/docs/src/reference/the-traversal.asciidoc
----------------------------------------------------------------------
diff --cc docs/src/reference/the-traversal.asciidoc
index 0376255,a7b1e29..1139306
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@@ -214,9 -210,11 +214,14 @@@ g.addE('knows').from(marko).to(peter) <
  <4> The newly created edge is a traversable object.
  <5> Two arbitrary bindings in a traversal can be joined `from()`->`to()`, where `id` can be provided for graphs that
  supports user provided ids.
 +<6> Add an edge between marko and peter given the directed (detached) vertex references.
 +<7> Add an edge between marko and peter given the directed (detached) vertex references.
  
+ *Additional References*
+ 
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addEdge(String)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addEdge(String)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addE(Traversal)`]
+ 
  [[addvertex-step]]
  === AddVertex Step
  
@@@ -232,6 -230,11 +237,12 @@@ g.V().has('name','nothing'
  g.V().has('name','nothing').bothE()
  ----
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV--[`addV()`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-java.lang.String-[`addV(String)`])
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-java.lang.String-[`addV(String)`]),
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addV(Traversal)`]
+ 
  [[addproperty-step]]
  === AddProperty Step
  
@@@ -345,6 -361,10 +369,10 @@@ g.V().hasLabel('software').as('a','b','
       by(__.in('created').values('name').fold())
  ----
  
+ *Additional References*
+ 
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#as-java.lang.String-java.lang.String...-[`as(String...)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#as-java.lang.String-java.lang.String...-[`as(String, String...)`]
+ 
  [[barrier-step]]
  === Barrier Step
  
@@@ -521,6 -576,10 +584,10 @@@ g.V(1).property('nickname', 'okram'
  g.V().hasLabel('person').coalesce(values('nickname'), values('name'))
  ----
  
+ *Additional References*
+ 
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coalesce-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`coalesce(Traversal)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coalesce-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`coalesce(Traversal...)`]
+ 
  [[coin-step]]
  === Coin Step
  
@@@ -731,6 -833,11 +841,12 @@@ means by which they are added. The gene
  The list of steps that support `from()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
   <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-java.lang.String-[`from(String)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.structure.Vertex-[`from(Vertex)`]
+ 
  [[group-step]]
  === Group Step
  
@@@ -893,6 -1056,27 +1065,27 @@@ g.V().where(__.in('created').values('ag
  <2> Find projects having two or more contributors.
  <3> Find projects whose contributors average age is between 30 and 35.
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#is-java.lang.Object-[`is(Object)`],
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#is-org.apache.tinkerpop.gremlin.process.traversal.P-[`is(P)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/P.html[`P`]  
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/P.html[`P`]
+ 
+ [[key-step]]
+ === Key Step
+ 
+ The `key()`-step (*map*) takes a `Property` and extracts the key from it.
+ 
+ [gremlin-groovy,theCrew]
+ ----
+ g.V(1).properties().key()
+ g.V(1).properties().properties().key()
+ ----
+ 
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#key--[`key()`]
+ 
  [[label-step]]
  === Label Step
  
@@@ -1212,50 -1404,10 +1412,58 @@@ system to leverage the filter for inde
  IMPORTANT: A `where()`-step is a filter and thus, variables within a `where()` clause are not globally bound to the
  path of the traverser in `match()`. As such, `where()`-steps in `match()` are used for filtering, not binding.
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#match-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`match(Traversal...)`]
+ 
 +[[math-step]]
 +=== Math Step
 +
 +The `math()`-step (*math*) enables scientific calculator functionality within Gremlin. This step deviates from the common
 +function composition and nesting formalisms to provide an easy to read string-based math processor. Variables within the
 +equation map to scopes in Gremlin -- e.g. path labels, side-effects, or incoming map keys. This step supports
 +`by()`-modulation where the `by()`-modulators are applied in the order in which the variables are first referenced
 +within the equation. Note that the reserved variable `_` refers to the current numeric traverser object incoming to the
 +`math()`-step.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().as('a').out('knows').as('b').math('a + b').by('age')
 +g.V().as('a').out('created').as('b').
 +  math('b + a').
 +    by(both().count().math('_ + 100')).
 +    by('age')
 +g.withSideEffect('x',10).V().values('age').math('_ / x')
 +g.withSack(1).V(1).repeat(sack(sum).by(constant(1))).times(10).emit().sack().math('sin _')
 +----
 +
 +The operators supported by the calculator include: `*`, `+`, `\`, `^`, and `%`.
 +Furthermore, the following built in functions are provided:
 +
 +* `abs`: absolute value
 +* `acos`: arc cosine
 +* `asin`: arc sine
 +* `atan`: arc tangent
 +* `cbrt`: cubic root
 +* `ceil`: nearest upper integer
 +* `cos`: cosine
 +* `cosh`: hyperbolic cosine
 +* `exp`: euler's number raised to the power (`e^x`)
 +* `floor`: nearest lower integer
 +* `log`: logarithmus naturalis (base e)
 +* `log10`: logarithm (base 10)
 +* `log2`: logarithm (base 2)
 +* `sin`: sine
 +* `sinh`: hyperbolic sine
 +* `sqrt`: square root
 +* `tan`: tangent
 +* `tanh`: hyperbolic tangent
 +* `signum`: signum function
 +
++*Additional References*
++
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#math-java.lang.String-[`math(String)`]
++
  [[max-step]]
  === Max Step
  
@@@ -1316,7 -1486,11 +1542,11 @@@ g.V().hasLabel('person')
  ----
  
  <1> josh created two projects and vadas none
 - 
 +
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#not-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`not(Traversal)`]
+ 
  [[option-step]]
  === Option Step
  
@@@ -1529,8 -1727,12 +1783,12 @@@ path.
  path.b
  path.c
  path.d == path.e
 -----   
 +----
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#path--[`path()`]
+ 
  [[peerpressure-step]]
  === PeerPressure Step
  
@@@ -2109,34 -2361,10 +2417,44 @@@ g.V('A').as('a')
  <3> Traverse all acyclic 3-hop paths starting from vertex `A` and from there again all 3-hop paths. The second path may
  cross the vertices from the first path.
  
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#simplePath--[`simplePath()`]
+ 
 +[[skip-step]]
 +=== Skip Step
 +
 +The `skip()`-step is analogous to <<range-step,`range()`-step>> save that the higher end range is set to -1.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().values('age').order()
 +g.V().values('age').order().skip(2)
 +g.V().values('age').order().range(2, -1)
 +----
 +
 +The `skip()`-step can also be applied with `Scope.local`, in which case it operates on the incoming collection.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().hasLabel('person').filter(outE('created')).as('p'). <1>
 +  map(out('created').values('name').fold()).
 +  project('person','primary','other').
 +    by(select('p').by('name')).
 +    by(limit(local, 1)). <2>
 +    by(skip(local, 1)) <3>
 +----
 +
 +<1> For each person who created something...
 +<2> ...select the first project (random order) as `primary` and...
 +<3> ...select all other projects as `other`.
 +
++*Additional References*
++
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-long-[`skip(long)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[`skip(Scope,long)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
++
  [[store-step]]
  === Store Step
  
@@@ -2255,6 -2497,13 +2587,14 @@@ g.V().valueMap().tail(local) <4
  <3> `List<String>` for each path containing the last two names from the 'a' step.
  <4> `Map<String, Object>` for each vertex, but containing only the last property value.
  
+ *Additional References*
+ 
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail--[`tail(long)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-long-[`tail(Scope)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[tail(Scope,long)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail--[`tail()`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-long-[`tail(long)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`tail(Scope)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[`tail(Scope,long)`]
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
+ 
  [[timelimit-step]]
  === TimeLimit Step
  
@@@ -2291,7 -2544,16 +2635,17 @@@ means by which they are added. The gene
  
  The list of steps that support `to()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
   <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
 - 
 +
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Direction,String...)`],
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(String)`],
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Traversal)`],
++link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.structure.Vertex-[`to(Vertex)`],
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toE-org.apache.tinkerpop.gremlin.structure.Direction-java.lang.String...-[`toE(Direction,String)`],
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toV-org.apache.tinkerpop.gremlin.structure.Direction-[`toV(Direction)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Direction.html[`Direction`] 
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Direction.html[`Direction`]
+ 
  [[tree-step]]
  === Tree Step
  


[3/4] tinkerpop git commit: Minor cleanup of links in docs CTR

Posted by sp...@apache.org.
Minor cleanup of links in docs CTR


Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/953bf485
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/953bf485
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/953bf485

Branch: refs/heads/master
Commit: 953bf485091492ab7d29a7ac65d22badc12f7f29
Parents: df3d6d7
Author: Stephen Mallette <sp...@genoprime.com>
Authored: Fri Feb 2 14:25:20 2018 -0500
Committer: Stephen Mallette <sp...@genoprime.com>
Committed: Fri Feb 2 14:25:20 2018 -0500

----------------------------------------------------------------------
 docs/src/reference/the-traversal.asciidoc | 41 +++++++++++++-------------
 1 file changed, 21 insertions(+), 20 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/953bf485/docs/src/reference/the-traversal.asciidoc
----------------------------------------------------------------------
diff --git a/docs/src/reference/the-traversal.asciidoc b/docs/src/reference/the-traversal.asciidoc
index a7b1e29..db658b7 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -213,7 +213,7 @@ supports user provided ids.
 
 *Additional References*
 
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addEdge(String)`]
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addE(String)`]
 
 [[addvertex-step]]
 === AddVertex Step
@@ -363,7 +363,7 @@ g.V().hasLabel('software').as('a','b','c').
 
 *Additional References*
 
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#as-java.lang.String-java.lang.String...-[`as(String...)`]
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#as-java.lang.String-java.lang.String...-[`as(String,String...)`]
 
 [[barrier-step]]
 === Barrier Step
@@ -578,7 +578,7 @@ g.V().hasLabel('person').coalesce(values('nickname'), values('name'))
 
 *Additional References*
 
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coalesce-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`coalesce(Traversal)`]
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#coalesce-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`coalesce(Traversal...)`]
 
 [[coin-step]]
 === Coin Step
@@ -795,6 +795,21 @@ g.V().values('age').sum() <6>
 link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold--[`fold()`],
 link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold-E2-java.util.function.BiFunction-[`fold(Object,BiFunction)`]
 
+[[from-step]]
+=== From Step
+
+The `from()`-step is not an actual step, but instead is a "step-modulator" similar to <<as-step,`as()`>> and
+<<by-step,`by()`>>. If a step is able to accept traversals or strings then `from()` is the
+means by which they are added. The general pattern is `step().from()`. See <<to-step,`to()`>>-step.
+
+The list of steps that support `from()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
+ <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
+
+*Additional References*
+
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-java.lang.String-[`from(String)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`]
+
 [[graph-step]]
 === Graph Step
 
@@ -823,21 +838,6 @@ g.V().has('name', within('marko', 'vadas', 'josh')).as('person').
 
 link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#V-java.lang.Object...-[`V(Object...)`]
 
-[[from-step]]
-=== From Step
-
-The `from()`-step is not an actual step, but instead is a "step-modulator" similar to <<as-step,`as()`>> and
-<<by-step,`by()`>>. If a step is able to accept traversals or strings then `from()` is the
-means by which they are added. The general pattern is `step().from()`. See <<to-step,`to()`>>-step.
-
-The list of steps that support `from()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
- <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
-
-*Additional References*
-
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-java.lang.String-[`from(String)`],
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`]
-
 [[group-step]]
 === Group Step
 
@@ -2499,8 +2499,9 @@ g.V().valueMap().tail(local) <4>
 
 *Additional References*
 
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail--[`tail(long)`],
-link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-long-[`tail(Scope)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail--[`tail()`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-long-[`tail(long)`],
+link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-[`tail(Scope)`]
 link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#tail-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[tail(Scope,long)`]
 link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
 


[4/4] tinkerpop git commit: Merge branch 'tp32'

Posted by sp...@apache.org.
Merge branch 'tp32'

Conflicts:
	docs/src/reference/the-traversal.asciidoc


Project: http://git-wip-us.apache.org/repos/asf/tinkerpop/repo
Commit: http://git-wip-us.apache.org/repos/asf/tinkerpop/commit/6c38c50b
Tree: http://git-wip-us.apache.org/repos/asf/tinkerpop/tree/6c38c50b
Diff: http://git-wip-us.apache.org/repos/asf/tinkerpop/diff/6c38c50b

Branch: refs/heads/master
Commit: 6c38c50b260e1efe8cb6489ff30cce8ab327cc9d
Parents: abfa44f 953bf48
Author: Stephen Mallette <sp...@genoprime.com>
Authored: Fri Feb 2 14:31:53 2018 -0500
Committer: Stephen Mallette <sp...@genoprime.com>
Committed: Fri Feb 2 14:31:53 2018 -0500

----------------------------------------------------------------------
 docs/src/reference/the-traversal.asciidoc | 54 +++++++++++++-------------
 1 file changed, 27 insertions(+), 27 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/tinkerpop/blob/6c38c50b/docs/src/reference/the-traversal.asciidoc
----------------------------------------------------------------------
diff --cc docs/src/reference/the-traversal.asciidoc
index 1139306,db658b7..9ffd953
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@@ -219,8 -213,7 +219,8 @@@ supports user provided ids
  
  *Additional References*
  
- link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addEdge(String)`],
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addE(Traversal)`]
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addE(String)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-java.lang.String-[`addE(String)`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addE-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addE(Traversal)`]
  
  [[addvertex-step]]
  === AddVertex Step
@@@ -240,8 -233,7 +240,8 @@@ g.V().has('name','nothing').bothE(
  *Additional References*
  
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV--[`addV()`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-java.lang.String-[`addV(String)`])
 +link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-java.lang.String-[`addV(String)`]),
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addV(Traversal)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#addV-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`addV(Traversal)`]
  
  [[addproperty-step]]
  === AddProperty Step
@@@ -803,6 -795,21 +803,22 @@@ g.V().values('age').sum() <6
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold--[`fold()`],
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#fold-E2-java.util.function.BiFunction-[`fold(Object,BiFunction)`]
  
+ [[from-step]]
+ === From Step
+ 
+ The `from()`-step is not an actual step, but instead is a "step-modulator" similar to <<as-step,`as()`>> and
+ <<by-step,`by()`>>. If a step is able to accept traversals or strings then `from()` is the
+ means by which they are added. The general pattern is `step().from()`. See <<to-step,`to()`>>-step.
+ 
+ The list of steps that support `from()`-modulation are: <<simplepath-step,`simplePath()`>>, <<cyclicpath-step,`cyclicPath()`>>,
+  <<path-step,`path()`>>, and <<addedge-step,`addE()`>>.
+ 
+ *Additional References*
+ 
+ link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-java.lang.String-[`from(String)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`from(Traversal)`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#from-org.apache.tinkerpop.gremlin.structure.Vertex-[`from(Vertex)`]
+ 
  [[graph-step]]
  === Graph Step
  
@@@ -1416,54 -1408,6 +1416,54 @@@ path of the traverser in `match()`. As 
  
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#match-org.apache.tinkerpop.gremlin.process.traversal.Traversal...-[`match(Traversal...)`]
  
 +[[math-step]]
 +=== Math Step
 +
 +The `math()`-step (*math*) enables scientific calculator functionality within Gremlin. This step deviates from the common
 +function composition and nesting formalisms to provide an easy to read string-based math processor. Variables within the
 +equation map to scopes in Gremlin -- e.g. path labels, side-effects, or incoming map keys. This step supports
 +`by()`-modulation where the `by()`-modulators are applied in the order in which the variables are first referenced
 +within the equation. Note that the reserved variable `_` refers to the current numeric traverser object incoming to the
 +`math()`-step.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().as('a').out('knows').as('b').math('a + b').by('age')
 +g.V().as('a').out('created').as('b').
 +  math('b + a').
 +    by(both().count().math('_ + 100')).
 +    by('age')
 +g.withSideEffect('x',10).V().values('age').math('_ / x')
 +g.withSack(1).V(1).repeat(sack(sum).by(constant(1))).times(10).emit().sack().math('sin _')
 +----
 +
 +The operators supported by the calculator include: `*`, `+`, `\`, `^`, and `%`.
 +Furthermore, the following built in functions are provided:
 +
 +* `abs`: absolute value
 +* `acos`: arc cosine
 +* `asin`: arc sine
 +* `atan`: arc tangent
 +* `cbrt`: cubic root
 +* `ceil`: nearest upper integer
 +* `cos`: cosine
 +* `cosh`: hyperbolic cosine
 +* `exp`: euler's number raised to the power (`e^x`)
 +* `floor`: nearest lower integer
 +* `log`: logarithmus naturalis (base e)
 +* `log10`: logarithm (base 10)
 +* `log2`: logarithm (base 2)
 +* `sin`: sine
 +* `sinh`: hyperbolic sine
 +* `sqrt`: square root
 +* `tan`: tangent
 +* `tanh`: hyperbolic tangent
 +* `signum`: signum function
 +
 +*Additional References*
 +
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#math-java.lang.String-[`math(String)`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#math-java.lang.String-[`math(String)`]
 +
  [[max-step]]
  === Max Step
  
@@@ -2421,40 -2365,6 +2421,40 @@@ cross the vertices from the first path
  
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#simplePath--[`simplePath()`]
  
 +[[skip-step]]
 +=== Skip Step
 +
 +The `skip()`-step is analogous to <<range-step,`range()`-step>> save that the higher end range is set to -1.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().values('age').order()
 +g.V().values('age').order().skip(2)
 +g.V().values('age').order().range(2, -1)
 +----
 +
 +The `skip()`-step can also be applied with `Scope.local`, in which case it operates on the incoming collection.
 +
 +[gremlin-groovy,modern]
 +----
 +g.V().hasLabel('person').filter(outE('created')).as('p'). <1>
 +  map(out('created').values('name').fold()).
 +  project('person','primary','other').
 +    by(select('p').by('name')).
 +    by(limit(local, 1)). <2>
 +    by(skip(local, 1)) <3>
 +----
 +
 +<1> For each person who created something...
 +<2> ...select the first project (random order) as `primary` and...
 +<3> ...select all other projects as `other`.
 +
 +*Additional References*
 +
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-long-[`skip(long)`],
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[`skip(Scope,long)`],
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-long-[`skip(long)`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#skip-org.apache.tinkerpop.gremlin.process.traversal.Scope-long-[`skip(Scope,long)`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/Scope.html[`Scope`]
 +
  [[store-step]]
  === Store Step
  
@@@ -2641,10 -2551,9 +2641,10 @@@ The list of steps that support `to()`-m
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Direction,String...)`],
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(String)`],
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.process.traversal.Traversal-[`to(Traversal)`],
- link:http://tinkerpop.apache.org/javadocs/3.3.2-SNAPSHOT/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.structure.Vertex-[`to(Vertex)`],
++link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#to-org.apache.tinkerpop.gremlin.structure.Vertex-[`to(Vertex)`],
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toE-org.apache.tinkerpop.gremlin.structure.Direction-java.lang.String...-[`toE(Direction,String)`],
  link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#toV-org.apache.tinkerpop.gremlin.structure.Direction-[`toV(Direction)`],
 -link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Direction.html[`Direction`] 
 +link:http://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/structure/Direction.html[`Direction`]
  
  [[tree-step]]
  === Tree Step