Author: spmallette
Date: Wed Apr 28 18:44:59 2021
New Revision: 1889276
URL: http://svn.apache.org/viewvc?rev=1889276&view=rev
Log:
Deploy docs for TinkerPop 3.5.0-SNAPSHOT
Modified:
tinkerpop/site/docs/3.5.0-SNAPSHOT/upgrade/index.html
tinkerpop/site/dotnetdocs/3.5.0-SNAPSHOT/index.json
tinkerpop/site/dotnetdocs/3.5.0-SNAPSHOT/manifest.json
tinkerpop/site/javadocs/3.5.0-SNAPSHOT/full/org/apache/tinkerpop/gremlin/process/traversal/Order.html
tinkerpop/site/javadocs/3.5.0-SNAPSHOT/full/org/apache/tinkerpop/gremlin/util/function/Lambda.BinaryLambda.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/AnonymousTraversalSource.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Authenticator.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Bytecode.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Client.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Connection.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/DriverRemoteConnection.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/EdgeLabelVerificationStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Graph.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphSON2Reader.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphSON2Writer.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphSON3Reader.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphSON3Writer.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphTraversal.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/GraphTraversalSource.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/HaltedTraverserStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/MatchAlgorithmStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/P.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/PartitionStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Path.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/PlainTextSaslAuthenticator.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/RemoteConnection.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/RemoteStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/RemoteTraversal.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/ReservedKeysVerificationStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/ResponseError.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/ResultSet.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/SaslAuthenticator.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/SaslMechanismBase.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/SaslMechanismPlain.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/SubgraphStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/TextP.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/Translator.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/TraversalStrategies.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/TraversalStrategy.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/TypeSerializer.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_auth_authenticator.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_auth_mechanisms_sasl-mechanism-base.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_auth_mechanisms_sasl-mechanism-plain.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_auth_plain-text-sasl-authenticator.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_auth_sasl-authenticator.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_client.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_connection.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_driver-remote-connection.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_remote-connection.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_response-error.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/driver_result-set.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/global.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/index.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_anonymous-traversal.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_bytecode.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_graph-traversal.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_translator.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_traversal-strategy.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/process_traversal.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/structure_graph.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/structure_io_graph-serializer.js.html
tinkerpop/site/jsdocs/3.5.0-SNAPSHOT/structure_io_type-serializers.js.html
Modified: tinkerpop/site/docs/3.5.0-SNAPSHOT/upgrade/index.html
URL:
http://svn.apache.org/viewvc/tinkerpop/site/docs/3.5.0-SNAPSHOT/upgrade/index.html?rev=1889276&r1=1889275&r2=1889276&view=diff
==============================================================================
--- tinkerpop/site/docs/3.5.0-SNAPSHOT/upgrade/index.html (original)
+++ tinkerpop/site/docs/3.5.0-SNAPSHOT/upgrade/index.html Wed Apr 28 18:44:59
2021
@@ -1719,7 +1719,7 @@ code formatter.</p>
<div class="paragraph">
<p><code>Translator</code> implementations were moved from a mostly quiet and
internal feature of TinkerPop to a documented and more
readily accessible form in 3.4.9. For 3.5.0, the functionality has been
expanded significantly in a number of ways.
-First, for Java, <code>gremlin-core</code> now has a
<code>JavascriptTranslator</code> and a <code>DotNetTranslator</code> which
complete the set of
+First, for Java, <code>gremlin-core</code> now has a
<code>JavascriptTranslator</code> and a <code>DotNetTranslator</code> which
completes the set of
Gremlin translation functions for the programming languages that TinkerPop
supports. It is therefore now possible to
convert Gremlin bytecode to string representations that can compile in C#,
Groovy, Javascript and Python.</p>
</div>
@@ -1776,8 +1776,8 @@ print(translator.translate(t.bytecode));
<div class="paragraph">
<p>There is a major breaking change in the use of <code>Configuration</code>
objects. Prior to 3.5.0, <code>Configuration</code> objects were
from the Apache Commons <code>commons-configuration</code> library, but in
this version, they are of <code>commons-configuration2</code>.
-While this is a breaking change, the fix for most implementations will be
quite simple, Simply, change the import
-statements from:</p>
+While this is a breaking change, the fix for most implementations will be
quite simple and amounts to changing the
+import statements from:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -1868,7 +1868,7 @@ and programmatic defaults have been modi
</div>
<div class="paragraph">
<p>It is still possible to utilize Gryo as a message serialization format by
modifying Gremlin Server configuration files
-to include the appropriate Gryo configurations. If using Gryo, do not user
earlier versions of the driver and server
+to include the appropriate Gryo configurations. If using Gryo, do not use
earlier versions of the driver and server
with 3.5.0. Use a 3.5.0 client to connect to a 3.5.0 server. Generally
speaking, mixed version combinations will
appear to work properly, but problems will likely occur during general course
of usage and it is therefore not
advisable to take this approach.</p>
@@ -1919,11 +1919,7 @@ mean adding the following dependencies:<
</div>
<div class="paragraph">
<p>Gremlin.NET now also supports GraphBinary. GraphSON 3 however still remains
the default serialization format as
-GraphBinary should be considered experimental for this version.</p>
-</div>
-<div class="paragraph">
-<p>GraphBinary needs of course to be also enabled on the server side before it
can be used in the driver. It can then be
-used like this:</p>
+GraphBinary should be considered experimental for this version in .NET:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -1936,12 +1932,11 @@ var g = Traversal().WithRemote(new Drive
</div>
<div class="paragraph">
<p>Gremlin.NET now uses <code>System.Text.Json</code> instead of
Newtonsoft.Json as <code>System.Text.Json</code> is already included in .NET
-Core 3.0 and higher which means that we have one dependency less on this
platform and because it offers an increased
-performance.
-Most users should not notice this change. But users who have implemented their
own GraphSON serializers or
-deserializers probably have to change them accordingly. The same applies to
users that let Gremlin.NET return data
-without deserializing it first as the returned data types will change in this
case, for example from Newtonsoft.Json’s
-<code>JObject</code> or <code>JToken</code> to <code>JsonElement</code> with
<code>System.Text.Json</code>.</p>
+Core 3.0 and higher which removes a dependency and offers better performance.
Most users should not notice this change,
+however users who have implemented their own GraphSON serializers or
deserializers will need to modify them
+accordingly. The same applies to users that let Gremlin.NET return data
without deserializing it first as the returned
+data types will change in this case, for example from Newtonsoft.Json’s
<code>JObject</code> or <code>JToken</code> to <code>JsonElement</code> with
+<code>System.Text.Json</code>.</p>
</div>
<div class="paragraph">
<p><strong>Python dict Deserialization</strong></p>
@@ -1964,16 +1959,16 @@ these values are not hashable and will r
<a
href="https://issues.apache.org/jira/browse/TINKERPOP-2407";>TINKERPOP-2407</a>,
<a
href="https://issues.apache.org/jira/browse/TINKERPOP-2460";>TINKERPOP-2460</a>,
<a
href="https://issues.apache.org/jira/browse/TINKERPOP-2472";>TINKERPOP-2472</a>,
-<a
href="http://tinkerpop.apache.org/docs/3.5.0/dev/provider/#_supporting_gremlin_net_io";>Documentation
for custom JSON serialization with Gremlin.NET</a></p>
+<a
href="http://tinkerpop.apache.org/docs/3.5.0/dev/provider/#_supporting_gremlin_net_io";>Custom
JSON serialization with Gremlin.NET</a></p>
</div>
</div>
<div class="sect3">
<h4 id="_transaction_improvements">Transaction Improvements</h4>
<div class="paragraph">
<p>The TinkerPop Transaction API and its related features have not changed
much since TinkerPop 3.x was initially
-released. Transactions have remained a feature for embedded use cases and
script execution (where supported) even in
-the face of the rise of remote graph use cases. With the varying contexts that
exist for how and when transactions can
-be used, it has led to a fair bit of confusion.</p>
+released. Transactions that extend beyond the scope of a single traversal (or
request) have remained a feature for
+embedded use cases and script execution (where supported) even in the face of
the rise of remote graph use cases.
+With the varying contexts that exist for how and when transactions can be
used, it has led to a fair bit of confusion.</p>
</div>
<div class="paragraph">
<p>For 3.5.0, TinkerPop introduces a change in approach to transactions that
has the goal of unifying the API and features
@@ -1994,7 +1989,7 @@ model for embedded transactions.
</table>
</div>
<div class="paragraph">
-<p>The new model for transactions looks like this:</p>
+<p>The new model for using a transaction looks like this:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -2164,7 +2159,7 @@ gremlin> g.V().hasLabel('person').ele
</div>
</div>
<div class="paragraph">
-<p>Then, assuming <code>null</code> is supported as a property value:</p>
+<p>Then, assuming <code>null</code> is supported as a property value, it would
simply store the <code>null</code> for the key:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -2177,7 +2172,7 @@ gremlin> g.V().has('person','age',nul
</div>
</div>
<div class="paragraph">
-<p>The above described changes also has an effect on steps like
<code>group()</code> and <code>groupCount()</code> which formerly produced
+<p>The above described changes also have an effect on steps like
<code>group()</code> and <code>groupCount()</code> which formerly produced
exceptions when keys could not be found:</p>
</div>
<div class="listingblock">
@@ -2189,9 +2184,9 @@ Display stack trace? [yN]n</code></pre>
</div>
</div>
<div class="paragraph">
-<p>The solution was to filter away vertices that did not have the available
key so that such steps would work properly
-or to write a more complex <code>by()</code> modulator to better handle the
possibility of a missing key. With the latest changes
-however none of that is necessary unless desired:</p>
+<p>For situations where the key did not exist, the approach was to filter away
vertices that did not have the available
+key so that such steps would work properly or to write a more complex
<code>by()</code> modulator to better handle the possibility
+of a missing key. With the latest changes however none of that is necessary
unless desired:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -2200,7 +2195,7 @@ however none of that is necessary unless
</div>
</div>
<div class="paragraph">
-<p>In conclusion, this change in greater support of <code>null</code> may
affect the behavior of existing traversals written in past
+<p>In conclusion, this improved support of <code>null</code> may affect the
behavior of existing traversals written in past
versions of TinkerPop as it is no longer possible to rely on <code>null</code>
to expect a filtering action for traversers.
Please review existing Gremlin carefully to ensure that there are no
unintended consequences of this change and that
there are no opportunities to improve existing logic to take greater advantage
of this expansion of <code>null</code> semantics.</p>
@@ -2244,6 +2239,9 @@ gremlin> g.withStrategies(new SeedStr
==>[lop,peter,josh,marko,vadas,ripple]</code></pre>
</div>
</div>
+<div class="paragraph">
+<p>See: <a
href="https://issues.apache.org/jira/browse/TINKERPOP-2014";>TINKERPOP-2014</a></p>
+</div>
</div>
<div class="sect3">
<h4 id="_byt_for_property">by(T) for Property</h4>
@@ -2361,7 +2359,7 @@ formerly held the cache for these side-e
<p><strong>Audit Logging</strong></p>
</div>
<div class="paragraph">
-<p>The <code>authentication.enableAuditlog</code> configuration property is
deprecated, but replaced by the <code>enableAuditLog</code> property
+<p>The <code>authentication.enableAuditlog</code> configuration property is
deprecated and replaced by the <code>enableAuditLog</code> property
to also make it available to <code>Authorizer</code> implementations. With the
new setting enabled, there are slight changes in the
formatting of audit log messages. In particular, the name of the authenticated
user is included in every message.</p>
</div>
@@ -2767,7 +2765,7 @@ they so choose.</p>
<div class="sect4">
<h5 id="_scalarmapstep">ScalarMapStep</h5>
<div class="paragraph">
-<p><code>MapStep</code> had a single abstract method that needed to be
implemented:</p>
+<p>Previous versions of <code>MapStep</code> had a single abstract method that
needed to be implemented:</p>
</div>
<div class="listingblock">
<div class="content">
@@ -11484,7 +11482,7 @@ gremlin> g.E()
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2021-04-28 13:44:41 -0400
+Last updated 2021-04-28 14:42:56 -0400
</div>
</div>
</body>
