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 2021/04/28 18:45:00 UTC
svn commit: r1889276 [1/3] - in /tinkerpop/site:
docs/3.5.0-SNAPSHOT/upgrade/ dotnetdocs/3.5.0-SNAPSHOT/
javadocs/3.5.0-SNAPSHOT/full/org/apache/tinkerpop/gremlin/process/traversal/
javadocs/3.5.0-SNAPSHOT/full/org/apache/tinkerpop/gremlin/util/functio...
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>