Add Javadoc to specify that CSOT does not limit socket writes

driver-core/src/main/com/mongodb/ClientEncryptionSettings.java

@@ -172,10 +172,15 @@ public Builder keyExpiration(@Nullable final Long keyExpiration, final TimeUnit
          *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
          * </ul>
          *
-         * <p><strong>Note:</strong> The timeout set through this method overrides the timeout defined in the key vault client settings
-         * specified in {@link #keyVaultMongoClientSettings(MongoClientSettings)}.
-         * Essentially, for operations that require accessing the key vault, the remaining timeout from the initial operation
-         * determines the duration allowed for key vault access.</p>
+         * <p><strong>NOTE:</strong></p>
+         * <ul>
+         *   <li>The timeout set through this method overrides the timeout defined in the key vault client settings
+         *       specified in {@link #keyVaultMongoClientSettings(MongoClientSettings)}.
+         *       Essentially, for operations that require accessing the key vault, the remaining timeout from the initial operation
+         *       determines the duration allowed for key vault access.</li>
+         *   <li>When using synchronous API, this timeout does not limit socket writes, therefore there is a possibility that the
+         *       operation might not be timed out when expected. This limitation does not apply to the reactive streams API.</li>
+         * </ul>
          *
          * @param timeout the timeout
          * @param timeUnit the time unit

driver-core/src/main/com/mongodb/ClientSessionOptions.java

@@ -220,6 +220,11 @@ public Builder defaultTransactionOptions(final TransactionOptions defaultTransac
          *   <li>{@code withTransaction}</li>
          *   <li>{@code close}</li>
          * </ul>
+         *
+         *  <p><strong>NOTE:</strong> When using synchronous API, this timeout does not limit socket writes, therefore
+         *  there is a possibility that the operation might not be timed out when expected. This limitation does not
+         *  apply to the reactive streams API.
+         *
          * @param defaultTimeout the timeout
          * @param timeUnit the time unit
          * @return this

driver-core/src/main/com/mongodb/MongoClientSettings.java

@@ -699,6 +699,9 @@ public Builder inetAddressResolver(@Nullable final InetAddressResolver inetAddre
          *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
          * </ul>
          *
+         *  <p><strong>NOTE:</strong> When using synchronous API, this timeout does not limit socket writes, therefore there is a possibility that the
+         *  operation might not be timed out when expected. This limitation does not apply to the reactive streams API.
+         *
          * @param timeout the timeout
          * @param timeUnit the time unit
          * @return this

driver-core/src/main/com/mongodb/TransactionOptions.java

@@ -292,6 +292,9 @@ public Builder maxCommitTime(@Nullable final Long maxCommitTime, final TimeUnit
          *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
          * </ul>
          *
+         *  <p><strong>NOTE:</strong> When using synchronous API, this timeout does not limit socket writes, therefore there is a possibility that the
+         *  operation might not be timed out when expected. This limitation does not apply to the reactive streams API.
+         *
          * @param timeout the timeout
          * @param timeUnit the time unit
          * @return this

driver-kotlin-sync/src/main/kotlin/com/mongodb/kotlin/client/MongoCluster.kt

@@ -78,6 +78,9 @@ public open class MongoCluster protected constructor(private val wrapped: JMongo
      * - `0` means infinite timeout.
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @return the optional timeout duration
      */
     @Alpha(Reason.CLIENT)
@@ -131,6 +134,9 @@ public open class MongoCluster protected constructor(private val wrapped: JMongo
      * - `0` means an infinite timeout
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit, defaults to Milliseconds
      * @return a new MongoCluster instance with the set time limit for operations

driver-kotlin-sync/src/main/kotlin/com/mongodb/kotlin/client/MongoCollection.kt

@@ -102,6 +102,9 @@ public class MongoCollection<T : Any>(private val wrapped: JMongoCollection<T>)
      * - `0` means infinite timeout.
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @return the optional timeout duration
      * @since 5.2
      */
@@ -176,6 +179,9 @@ public class MongoCollection<T : Any>(private val wrapped: JMongoCollection<T>)
      * - `0` means an infinite timeout
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit, defaults to Milliseconds
      * @return a new MongoCollection instance with the set time limit for operations

driver-kotlin-sync/src/main/kotlin/com/mongodb/kotlin/client/MongoDatabase.kt

@@ -71,6 +71,9 @@ public class MongoDatabase(private val wrapped: JMongoDatabase) {
      * - `0` means infinite timeout.
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @return the optional timeout duration
      * @since 5.2
      */
@@ -125,6 +128,9 @@ public class MongoDatabase(private val wrapped: JMongoDatabase) {
      * - `0` means an infinite timeout
      * - `> 0` The time limit to use for the full execution of an operation.
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit, defaults to Milliseconds
      * @return a new MongoDatabase instance with the set time limit for operations

driver-legacy/src/main/com/mongodb/MongoClientOptions.java

@@ -1370,6 +1370,9 @@ public Builder srvServiceName(final String srvServiceName) {
          *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
          * </ul>
          *
+         *  <p><strong>Note:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+         *  operation might not be timed out when expected.
+         *
          * @param timeoutMS the timeout in milliseconds
          * @return this
          * @since 5.2

driver-sync/src/main/com/mongodb/client/MongoCluster.java

@@ -169,6 +169,9 @@ public interface MongoCluster {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit
      * @return a new MongoCluster instance with the set time limit for the full execution of an operation.

driver-sync/src/main/com/mongodb/client/MongoCollection.java

@@ -204,6 +204,9 @@ public interface MongoCollection<TDocument> {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit
      * @return a new MongoCollection instance with the set time limit for the full execution of an operation

driver-sync/src/main/com/mongodb/client/MongoDatabase.java

@@ -160,6 +160,9 @@ public interface MongoDatabase {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit
      * @return a new MongoDatabase instance with the set time limit for the full execution of an operation.

driver-sync/src/main/com/mongodb/client/gridfs/GridFSBucket.java

@@ -104,6 +104,9 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeUnit the time unit
      * @return the timeout in the given time unit
      * @since 4.x
@@ -155,6 +158,9 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     *  <p><strong>NOTE:</strong> This timeout does not limit socket writes, therefore there is a possibility that the
+     *  operation might not be timed out when expected.
+     *
      * @param timeout the timeout, which must be greater than or equal to 0
      * @param timeUnit the time unit
      * @return a new GridFSBucket instance with the set time limit for the full execution of an operation