This is an automated email from the ASF dual-hosted git repository.
Cole-Greer pushed a commit to branch 3.8-dev
in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
The following commit(s) were added to refs/heads/3.8-dev by this push:
new acb5b0c45e Fix reference documentation inaccuracies (#3534)
acb5b0c45e is described below
commit acb5b0c45ee1da285e8536609d8d0783b33b37bd
Author: Guian Gumpac <[email protected]>
AuthorDate: Wed Jul 22 16:06:25 2026 -0700
Fix reference documentation inaccuracies (#3534)
Assisted-by: Kiro: Claude Opus 4.8
---
CHANGELOG.asciidoc | 1 +
docs/src/reference/gremlin-applications.asciidoc | 16 ++++----
docs/src/reference/gremlin-variants.asciidoc | 45 ++++++++++------------
docs/src/reference/implementations-neo4j.asciidoc | 2 +-
.../reference/implementations-tinkergraph.asciidoc | 8 ++--
docs/src/reference/intro.asciidoc | 2 +-
docs/src/reference/the-graphcomputer.asciidoc | 4 +-
docs/src/reference/the-traversal.asciidoc | 12 +++---
.../apache/tinkerpop/gremlin/driver/Settings.java | 6 +--
9 files changed, 48 insertions(+), 48 deletions(-)
diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc
index c4fc5400ef..e11b1cac65 100644
--- a/CHANGELOG.asciidoc
+++ b/CHANGELOG.asciidoc
@@ -32,6 +32,7 @@ This release also includes changes from prior 3.7.x releases.
* Bumped Hadoop to 3.4.3 (and Kerby to 2.0.3) to enable `hadoop-gremlin` to
build and run on Java 25.
* Add missing `Configuring` interface to `GraphStepPlaceholder` and
`VertexStepPlaceholder`
* Fixed bug in `group()` value traversal where keys were retained with stale
barrier state instead of being filtered when steps following a `Barrier` in the
second `by()` produced no output (e.g. `by(values("age").fold().unfold())` or
`by(__.out().fold().count(local).is(P.gt(0)))` for vertices with no out-edges).
+* Corrected numerous inaccuracies in the reference documentation, including
wrong default values (connection pool sizes, buffer sizes, ports, timeouts),
stale serializer class names, removed options documented as available, and
broken code examples across the JVM, Python, `.NET`, Go, and JavaScript drivers.
[[release-3-8-1]]
=== TinkerPop 3.8.1 (Release Date: April 1, 2026)
diff --git a/docs/src/reference/gremlin-applications.asciidoc
b/docs/src/reference/gremlin-applications.asciidoc
index c54359bc74..5c9acc9b09 100644
--- a/docs/src/reference/gremlin-applications.asciidoc
+++ b/docs/src/reference/gremlin-applications.asciidoc
@@ -81,9 +81,9 @@ $ bin/gremlin.sh
\,,,/
(o o)
-----oOOo-(3)-oOOo-----
-plugin loaded: tinkerpop.server
-plugin loaded: tinkerpop.utilities
-plugin loaded: tinkerpop.tinkergraph
+plugin activated: tinkerpop.server
+plugin activated: tinkerpop.utilities
+plugin activated: tinkerpop.tinkergraph
gremlin>
----
@@ -1026,7 +1026,7 @@ The following table describes the various YAML
configuration options that Gremli
|keepAliveInterval |Time in milliseconds that the server will allow a channel
to not send responses to a client before it sends a "ping" to see if it is
still present. If it is present, the client should respond with a "pong" which
will thus reset the `idleConnectionTimeout` and keep the channel open. If
enabled, this number should be smaller than the value provided to the
`idleConnectionTimeout`. Note that while this value is to be provided as
milliseconds it will resolve to second prec [...]
|maxAccumulationBufferComponents |Maximum number of request components that
can be aggregated for a message. |1024
|maxChunkSize |The maximum length of the content or each chunk. If the
content length exceeds this value, the transfer encoding of the decoded request
will be converted to 'chunked' and the content will be split into multiple
`HttpContent` objects. If the transfer encoding of the HTTP request is
'chunked' already, each chunk will be split into smaller chunks if the length
of the chunk exceeds this value. |8192
-|maxContentLength |The maximum length of the aggregated content for a message.
Works in concert with `maxChunkSize` where chunked requests are accumulated
back into a single message. A request exceeding this size will return a `413 -
Request Entity Too Large` status code. A response exceeding this size will
raise an internal exception. |65536
+|maxContentLength |The maximum length of the aggregated content for a message.
Works in concert with `maxChunkSize` where chunked requests are accumulated
back into a single message. A request exceeding this size will return a `413 -
Request Entity Too Large` status code. A response exceeding this size will
raise an internal exception. |10485760
|maxHeaderSize |The maximum length of all headers. |8192
|maxInitialLineLength |The maximum length of the initial line (e.g. "GET /
HTTP/1.0") processed in a request, which essentially controls the maximum
length of the submitted URI. |4096
|maxParameters |The maximum number of parameters that can be passed on a
request. Larger numbers may impact performance for scripts. This configuration
only applies to the `UnifiedChannelizer`. |16
@@ -1172,12 +1172,12 @@ available GraphSON serializers that can be configured:
[width="100%",cols="2,2,4,4",options="header"]
|=========================================================
|Version |Embedded Types |Mime Type |Class
-|1.0 |yes |`application/vnd.gremlin-v1.0+json`
|`GraphSONMessageSerializerGremlinV1`
+|1.0 |yes |`application/vnd.gremlin-v1.0+json` |`GraphSONMessageSerializerV1`
|1.0 |no |`application/vnd.gremlin-v1.0+json;types=false`
|`GraphSONUntypedMessageSerializerV1`
|2.0 |yes |`application/vnd.gremlin-v2.0+json` |`GraphSONMessageSerializerV2`
|2.0 |no |`application/vnd.gremlin-v2.0+json;types=false`
|`GraphSONUntypedMessageSerializerV2`
|3.0 |yes |`application/vnd.gremlin-v3.0+json` |`GraphSONMessageSerializerV3`
-|3.0 |no |`application/vnd.gremlin-v3.0+json;types=false`
|`GraphSONMessageSerializerV3`
+|3.0 |no |`application/vnd.gremlin-v3.0+json;types=false`
|`GraphSONUntypedMessageSerializerV3`
|=========================================================
The above serializer classes can be found in the
`org.apache.tinkerpop.gremlin.util.ser` package of `gremlin-util`.
@@ -1209,7 +1209,7 @@ JSON format which is a bit easier to consume than its
successors which embed dat
of GraphSON tends to be the one that users like to utilize when
<<connecting-via-http,connecting via HTTP>> and is still
used by some <<connecting-rgp, Remote Gremlin Providers>> for this purpose.
-To configure Gremlin Server this way, the `GraphSONMessageSerializerV1d0` must
be included:
+To configure Gremlin Server this way, the `GraphSONMessageSerializerV1` must
be included:
[source,yaml]
----
@@ -1217,7 +1217,7 @@ To configure Gremlin Server this way, the
`GraphSONMessageSerializerV1d0` must b
- { className:
org.apache.tinkerpop.gremlin.util.ser.GraphSONMessageSerializerV3 }
----
-In the above situation, both `GraphSONMessageSerializerV1d0` and
`GraphSONMessageSerializerV3d0` each bind to the
+In the above situation, both `GraphSONMessageSerializerV1` and
`GraphSONMessageSerializerV3` each bind to the
`application/json` mime type. When such conflicts arise, Gremlin Server will
use the order of the serializers to
determine priority such that the first serializer to bind to a type will be
used and the others ignored. The following
log message will indicate how the server is ultimately configured:
diff --git a/docs/src/reference/gremlin-variants.asciidoc
b/docs/src/reference/gremlin-variants.asciidoc
index 9547d87154..94a3797cc7 100644
--- a/docs/src/reference/gremlin-variants.asciidoc
+++ b/docs/src/reference/gremlin-variants.asciidoc
@@ -168,7 +168,7 @@ provide most of the typical functionality required to use
Gremlin:
[source,go]
----
import (
- "github.com/apache/tinkerpop/gremlin-go/driver"
+ "github.com/apache/tinkerpop/gremlin-go/v3/driver"
)
----
@@ -192,20 +192,20 @@ can be passed to the `NewClient` or
`NewDriverRemoteConnection` functions as con
|Key |Description |Default
|TraversalSource |Traversal source. |"g"
|TransporterType |Transporter type. |Gorilla
-|LogVerbosity |Log verbosity.|gremlingo.INFO
+|LogVerbosity |Log verbosity.|gremlingo.Info
|Logger |Instance of logger. |log
|Language |Language used for logging messages. |language.English
|AuthInfo |Authentification info, can be build with BasicAuthInfo() or
HeaderAuthInfo(). |empty
|TlsConfig |TLS configuration. |empty
|KeepAliveInterval |Keep connection alive interval. |5 seconds
|WriteDeadline |Write deadline. |3 seconds
-|ConnectionTimeout | Timeout for establishing connection. |45 seconds
+|ConnectionTimeout | Timeout for establishing connection. |5 seconds
|NewConnectionThreshold | Minimum amount of concurrent active traversals on a
connection to trigger creation of a new connection. |4
|MaximumConcurrentConnections | Maximum number of concurrent connections.
|number of runtime processors
|EnableCompression |Flag to enable compression. |false
-|ReadBufferSize |Specify I/O buffer sizes in bytes. If a buffer size is zero,
then a useful default size is used |0
-|WriteBufferSize |Specify I/O buffer sizes in bytes. If a buffer size is zero,
then a useful default size is used |0
-|Session |Session ID. |""
+|ReadBufferSize |Specify I/O buffer sizes in bytes. If a buffer size is zero,
then a useful default size is used |1048576
+|WriteBufferSize |Specify I/O buffer sizes in bytes. If a buffer size is zero,
then a useful default size is used |1048576
+|Session |Session ID. This field is unexported and not directly user-settable
via the NewDriverRemoteConnection configuration function; sessions are managed
via g.Tx()/session creation. |""
|EnableUserAgentOnConnect |Enables sending a user agent to the server during
connection requests.
More details can be found in provider docs
link:https://tinkerpop.apache.org/docs/x.y.z/dev/provider/#_graph_driver_provider_requirements[here].|true
@@ -855,14 +855,14 @@ The following table describes the various configuration
options for the Gremlin
|connectionPool.keyStore |The private key in JKS or PKCS#12 format. |_none_
|connectionPool.keyStorePassword |The password of the `keyStore` if it is
password-protected. |_none_
|connectionPool.keyStoreType |`PKCS12` |_none_
-|connectionPool.maxContentLength |The maximum length in bytes that a message
can be sent to the server. This number can be no greater than the setting of
the same name in the server configuration. |65536
+|connectionPool.maxContentLength |The maximum length in bytes that a message
can be sent to the server. This number can be no greater than the setting of
the same name in the server configuration. |10485760
|connectionPool.maxInProcessPerConnection |The maximum number of in-flight
requests that can occur on a connection. |4
|connectionPool.maxSimultaneousUsagePerConnection |The maximum number of times
that a connection can be borrowed from the pool simultaneously. |16
|connectionPool.maxSize |The maximum size of a connection pool for a host. |8
-|connectionPool.maxWaitForConnection |The amount of time in milliseconds to
wait for a new connection before timing out. |3000
+|connectionPool.maxWaitForConnection |The amount of time in milliseconds to
wait for a new connection before timing out. |16000
|connectionPool.maxWaitForClose |The amount of time in milliseconds to wait
for pending messages to be returned from the server before closing the
connection. |3000
|connectionPool.minInProcessPerConnection |The minimum number of in-flight
requests that can occur on a connection. |1
-|connectionPool.minSimultaneousUsagePerConnection |The maximum number of times
that a connection can be borrowed from the pool simultaneously. |8
+|connectionPool.minSimultaneousUsagePerConnection |The minimum number of times
that a connection should be borrowed from the pool simultaneously before it can
be released when under low use. |8
|connectionPool.minSize |The minimum size of a connection pool for a host. |2
|connectionPool.reconnectInterval |The amount of time in milliseconds to wait
before trying to reconnect to a dead host. |1000
|connectionPool.resultIterationBatchSize |The override value for the size of
the result batches to be returned from the server. |64
@@ -880,7 +880,7 @@ The following table describes the various configuration
options for the Gremlin
|nioPoolSize |Size of the pool for handling request/response operations.
|available processors
|password |The password to submit on requests that require authentication.
|_none_
|path |The URL path to the Gremlin Server. |_/gremlin_
-|port |The port of the Gremlin Server to connect to. The same port will be
applied for all hosts. |8192
+|port |The port of the Gremlin Server to connect to. The same port will be
applied for all hosts. |8182
|protocol |Sets the `AuthProperties.Property.PROTOCOL` properties for
authentication to Gremlin Server. |_none_
|reuseConnectionsForSessions |Uses a `Client` that will attempt to reuse
`Connections` when managing remote transactions with a
`DriverRemoteConnection`. |false
|serializer.className |The fully qualified class name of the
`MessageSerializer` that will be used to communicate with the server. Note that
the serializer configured on the client should be supported by the server
configuration. |_none_
@@ -1638,7 +1638,7 @@ Some connection options can also be set on individual
requests made through the
const vertices = await g.with_('evaluationTimeout',
500).V().out('knows').toList()
----
-The following options are allowed on a per-request basis in this fashion:
`batchSize`, `requestId`, `userAgent` and
+The following options are allowed on a per-request basis in this fashion:
`batchSize`, `requestId`, `userAgent`, `materializeProperties` and
`evaluationTimeout` (formerly `scriptEvaluationTimeout` which is also
supported but now deprecated).
[[gremlin-javascript-imports]]
@@ -1695,10 +1695,10 @@ can be passed in the constructor of a new `Client` or
`DriverRemoteConnection` :
|options |Object |The connection options. |{}
|options.ca |Array |Trusted certificates. |undefined
|options.cert |String/Array/Buffer |The certificate key. |undefined
-|options.mimeType |String |The mime type to use.
|'application/vnd.gremlin-v3.0+json'
+|options.mimeType |String |The mime type to use.
|'application/vnd.graphbinary-v1.0'
|options.pfx |String/Buffer |The private key, certificate, and CA certs.
|undefined
|options.reader |GraphSONReader/GraphBinaryReader |The reader to use. |select
reader according to mimeType
-|options.writer |GraphSONWriter |The writer to use. |select writer according
to mimeType
+|options.writer |GraphSONWriter/GraphBinaryWriter |The writer to use. |select
writer according to mimeType
|options.rejectUnauthorized |Boolean |Determines whether to verify or not the
server certificate. |undefined
|options.traversalSource |String |The traversal source. |'g'
|options.authenticator |Authenticator |The authentication handler to use.
|undefined
@@ -1707,9 +1707,6 @@ can be passed in the constructor of a new `Client` or
`DriverRemoteConnection` :
|options.enableCompression |Boolean |Enables permessage-deflate compression.
Note that use of compression may increase vulnerability to attacks such as
CRIME/BREACH.|false
|options.enableUserAgentOnConnect |Boolean |Determines if a user agent will be
sent during connection handshake. |true
|options.headers |Object |An associative array containing the additional
header key/values for the initial request. |undefined
-|options.pingEnabled |Boolean |Setup ping interval. |true
-|options.pingInterval |Number |Ping request interval in ms if ping enabled.
|60000
-|options.pongTimeout |Number |Timeout of pong response in ms after sending a
ping. |30000
|=========================================================
[[gremlin-javascript-logging]]
@@ -2203,8 +2200,8 @@ on the `ConnectionPoolSettings` instance that can be
passed to the `GremlinClien
[width="100%",cols="3,10,^2",options="header"]
|=========================================================
|Key |Description |Default
-|PoolSize |The size of the connection pool. |4
-|MaxInProcessPerConnection |The maximum number of in-flight requests that can
occur on a connection. |32
+|PoolSize |The size of the connection pool. |8
+|MaxInProcessPerConnection |The maximum number of in-flight requests that can
occur on a connection. |16
|ReconnectionAttempts |The number of attempts to get an open connection from
the pool to submit a request. |4
|ReconnectionBaseDelay |The base delay used for the exponential backoff for
the reconnection attempts. |1 s
|EnableUserAgentOnConnect |Enables sending a user agent to the server during
connection requests.
@@ -2212,7 +2209,7 @@ More details can be found in provider docs
link:https://tinkerpop.apache.org/docs/x.y.z/dev/provider/#_graph_driver_provider_requirements[here].|true
|=========================================================
-A `NoConnectionAvailableException` is thrown if all connections have reached
the `MaxInProcessPerConnection` limit
+A `ConnectionPoolBusyException` is thrown if all connections have reached the
`MaxInProcessPerConnection` limit
when a new request comes in.
A `ServerUnavailableException` is thrown if no connection is available to the
server to submit a request after
`ReconnectionAttempts` retries.
@@ -2642,7 +2639,7 @@ Some connection options can also be set on individual
requests made through the
vertices = g.with_('evaluationTimeout', 500).V().out('knows').to_list()
----
-The following options are allowed on a per-request basis in this fashion:
`batchSize`, `requestId`, `userAgent` and
+The following options are allowed on a per-request basis in this fashion:
`batchSize`, `requestId`, `userAgent`, `materializeProperties` and
`evaluationTimeout` (formerly `scriptEvaluationTimeout` which is also
supported but now deprecated).
anchor:python-imports[]
@@ -2730,15 +2727,15 @@ can be passed to the `Client` or
`DriverRemoteConnection` instance as keyword ar
[width="100%",cols="3,10,^2",options="header"]
|=========================================================
|Key |Description |Default
-|enable_compression |Enables sending a user agent to the server during
connection requests. |False
+|enable_compression |Enables compression of messages sent to the server. |False
|enable_user_agent_on_connect |Enables sending a user agent to the server
during connection requests. More details can be found in provider docs
link:https://tinkerpop.apache.org/docs/x.y.z/dev/provider/#_graph_driver_provider_requirements[here].|True
|headers |Additional headers that will be added to each request message.
|`None`
-|kerberized_service |the first part of the principal name configured for the
gremlin service|"""
-|max_workers |Maximum number of worker threads. |Number of CPUs * 5
+|kerberized_service |the first part of the principal name configured for the
gremlin service|""
+|max_workers |Maximum number of worker threads. |Same as pool_size (default 8)
|message_serializer |The message serializer
implementation.|`gremlin_python.driver.serializer.GraphBinarySerializersV1`
|password |The password to submit on requests that require authentication. |""
-|pool_size |The number of connections used by the pool. |4
+|pool_size |The number of connections used by the pool. |8
|protocol_factory |A callable that returns an instance of
`AbstractBaseProtocol`.
|`gremlin_python.driver.protocol.GremlinServerWSProtocol`
|session | A unique string-based identifier (typically a UUID) to enable a
<<sessions,session-based connection>>. This is not a valid configuration for
`DriverRemoteConnection`. |None
|transport_factory |A callable that returns an instance of
`AbstractBaseTransport`.
|`gremlin_python.driver.aiohttp.transport.AiohttpTransport`
diff --git a/docs/src/reference/implementations-neo4j.asciidoc
b/docs/src/reference/implementations-neo4j.asciidoc
index 4cae3bb8ef..239a006274 100644
--- a/docs/src/reference/implementations-neo4j.asciidoc
+++ b/docs/src/reference/implementations-neo4j.asciidoc
@@ -291,7 +291,7 @@ main difference is the usage of HA configuration options
that enable the cluster
from the TinkerPop perspective is largely the same.
In configuring for HA the most important thing to realize is that all Neo4j HA
settings are simply passed through the
-TinkerPop configuration settings given to the `GraphFactory.open()` or
`Neo4j.open()` methods. For example, to
+TinkerPop configuration settings given to the `GraphFactory.open()` or
`Neo4jGraph.open()` methods. For example, to
provide the all-important `ha.server_id` configuration option through
TinkerPop, simply prefix that key with the
TinkerPop Neo4j key of `gremlin.neo4j.conf`.
diff --git a/docs/src/reference/implementations-tinkergraph.asciidoc
b/docs/src/reference/implementations-tinkergraph.asciidoc
index 1dc7b122f1..b8a1cd889b 100644
--- a/docs/src/reference/implementations-tinkergraph.asciidoc
+++ b/docs/src/reference/implementations-tinkergraph.asciidoc
@@ -97,7 +97,7 @@ Given the initial graph construction in the first code block,
no index was defin
However, if the graph was constructed as such, then an index lookup would be
used.
[source,java]
-Graph g = TinkerGraph.open();
+TinkerGraph g = TinkerGraph.open();
g.createIndex("name",Vertex.class)
The execution times for a vertex lookup by property is provided below for both
no-index and indexed version of
@@ -277,7 +277,7 @@ public class GraphService {
// suitable test graph replacement for our actual production graph.
public class GraphServiceTest {
private static final TinkerTransactionGraph graph =
TinkerTransactionGraph.open();
- private static final GraphTraversalSource g = traversal.with(graph);
+ private static final GraphTraversalSource g = traversal().with(graph);
private static final GraphService service = new GraphService(g);
@Test
@@ -297,8 +297,8 @@ public class GraphServiceTest {
// with this approach you could also configure your production graph directly
or use custom
// build options to trigger different test configurations for a more dynamic
approach
public class GraphServiceTest {
- private static final GraphTraversalSource g = traversal.with(
- new DriverRemoteConnection('ws://localhost:8182/gremlin'));
+ private static final GraphTraversalSource g = traversal().with(
+ new DriverRemoteConnection("ws://localhost:8182/gremlin"));
private static final GraphService service = new GraphService(g);
@Test
diff --git a/docs/src/reference/intro.asciidoc
b/docs/src/reference/intro.asciidoc
index 76f3abcc73..e001f9dc97 100644
--- a/docs/src/reference/intro.asciidoc
+++ b/docs/src/reference/intro.asciidoc
@@ -157,7 +157,7 @@ NOTE: The TinkerPop API rides a fine line between providing
concise "query langu
Java method naming standards. The general convention used throughout TinkerPop
is that if a method is "user exposed,"
then a concise name is provided (e.g. `out()`, `path()`, `repeat()`). If the
method is primarily for graph systems
providers, then the standard Java naming convention is followed (e.g.
`getNextStep()`, `getSteps()`,
-`getElementComputeKeys()`).
+`getVertexComputeKeys()`).
[[graph-structure]]
=== The Graph Structure
diff --git a/docs/src/reference/the-graphcomputer.asciidoc
b/docs/src/reference/the-graphcomputer.asciidoc
index 60988d1e98..788fde7be8 100644
--- a/docs/src/reference/the-graphcomputer.asciidoc
+++ b/docs/src/reference/the-graphcomputer.asciidoc
@@ -459,8 +459,8 @@ The `ShortestPathVertexProgram.Builder` provides the
following configuration met
| `edgeTraversal(Traversal)` | Sets a traversal that emits the edges to
traverse from the current vertex. | `__.bothE()`
| `distanceProperty(String)` | Sets the edge property to use for the distance
calculations. | none
| `distanceTraversal(Traversal)` | Sets the traversal that calculates the
distance for the current edge. | `__.constant(1)`
-| `maxDistance(Traversal)` | Limits the shortest path distance. | none
-| `includeEdges(Boolean)` | Whether to include edges in shortest paths or not.
| `false`
+| `maxDistance(Number)` | Limits the shortest path distance. | none
+| `includeEdges(boolean)` | Whether to include edges in shortest paths or not.
| `false`
|=========================================================
IMPORTANT: If a maximum distance is provided, the discovery process will only
stop to follow a path at this distance if there was no
diff --git a/docs/src/reference/the-traversal.asciidoc
b/docs/src/reference/the-traversal.asciidoc
index 6ce8da2c9e..99d70d6219 100644
--- a/docs/src/reference/the-traversal.asciidoc
+++ b/docs/src/reference/the-traversal.asciidoc
@@ -948,7 +948,7 @@ robust steps like <<choose-step, choose()>> and
<<union-step,union()>>.
*Additional References*
-link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#branch(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`map(Traversal)`]
+link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#branch(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`branch(Traversal)`]
[[by-step]]
=== By Step
@@ -1526,10 +1526,12 @@
g.inject("2023-08-02T00:00:00Z").asDate().dateDiff(constant("2023-08-03T00:00:00
<1> Find difference between two dates in milliseconds
+NOTE: The `dateDiff(Date)` method is deprecated as of 3.8.0 in favor of
`dateDiff(OffsetDateTime)`.
+
*Additional References*
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dateDiff(java.util.Date)++[`dateDiff(Date)`],
-link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dateDiff(java.util.Date)++[`dateDiff(OffsetDateTime)`],
+link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dateDiff(java.time.OffsetDateTime)++[`dateDiff(OffsetDateTime)`],
link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#dateDiff(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`dateDiff(Traversal)`]
[[dedup-step]]
@@ -1864,7 +1866,7 @@ information.
*Additional References*
-link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#filter(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`map(Traversal)`]
+link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#filter(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`filter(Traversal)`]
[[flatmap-step]]
=== FlatMap Step
@@ -1887,7 +1889,7 @@ gremlin>
g.withSack(1.0f).V(1).barrier().flatMap(sack(mult).by("age")).sack()
*Additional References*
-link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#flatMap(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`map(Traversal)`]
+link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#flatMap(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`flatMap(Traversal)`]
[[format-step]]
=== Format Step
@@ -4588,7 +4590,7 @@ see the <<general-steps, General Steps>> section for more
information.
*Additional References*
-link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sideEffect(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`map(Traversal)`]
+link:++https://tinkerpop.apache.org/javadocs/x.y.z/core/org/apache/tinkerpop/gremlin/process/traversal/dsl/graph/GraphTraversal.html#sideEffect(org.apache.tinkerpop.gremlin.process.traversal.Traversal)++[`sideEffect(Traversal)`]
[[simplepath-step]]
=== SimplePath Step
diff --git
a/gremlin-driver/src/main/java/org/apache/tinkerpop/gremlin/driver/Settings.java
b/gremlin-driver/src/main/java/org/apache/tinkerpop/gremlin/driver/Settings.java
index c614223997..b799d3290c 100644
---
a/gremlin-driver/src/main/java/org/apache/tinkerpop/gremlin/driver/Settings.java
+++
b/gremlin-driver/src/main/java/org/apache/tinkerpop/gremlin/driver/Settings.java
@@ -44,7 +44,7 @@ import java.util.stream.Collectors;
final class Settings {
/**
- * The port of the Gremlin Server to connect to which defaults to {@code
8192}. The same port will be applied for
+ * The port of the Gremlin Server to connect to which defaults to {@code
8182}. The same port will be applied for
* all {@link #hosts}.
*/
public int port = 8182;
@@ -382,7 +382,7 @@ final class Settings {
/**
* The amount of time in milliseconds to wait for a new connection
before timing out where the default value
- * is 3000.
+ * is 16000.
*/
public int maxWaitForConnection = Connection.MAX_WAIT_FOR_CONNECTION;
@@ -395,7 +395,7 @@ final class Settings {
/**
* The maximum length in bytes that a message can be sent to the
server. This number can be no greater than
- * the setting of the same name in the server configuration. The
default value is 65536.
+ * the setting of the same name in the server configuration. The
default value is 10485760.
*/
public int maxContentLength = Connection.MAX_CONTENT_LENGTH;
