Add documentation to GridFSBucket.

Author: vbabanin

driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/gridfs/GridFSBucket.java

@@ -26,6 +26,7 @@
 import com.mongodb.client.gridfs.model.GridFSUploadOptions;
 import com.mongodb.lang.Nullable;
 import com.mongodb.reactivestreams.client.ClientSession;
+import com.mongodb.reactivestreams.client.MongoDatabase;
 import org.bson.BsonValue;
 import org.bson.conversions.Bson;
 import org.bson.types.ObjectId;
@@ -102,9 +103,13 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     * <p>If not set, the timeout is inherited from whatever the
+     * {@linkplain MongoDatabase#getTimeout MongoDatabase} was resolved to.
+     *
      * @param timeUnit the time unit
      * @return the timeout in the given time unit
      * @since 4.x
+     * @see #withTimeout
      */
     @Alpha(Reason.CLIENT)
     @Nullable
@@ -152,6 +157,9 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     * <p>If not set, the timeout is inherited from whatever the
+     * {@linkplain MongoDatabase#getTimeout MongoDatabase} was resolved to.
+     *
      * @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

driver-scala/src/main/scala/org/mongodb/scala/gridfs/GridFSBucket.scala

@@ -120,7 +120,11 @@ case class GridFSBucket(private val wrapped: JGridFSBucket) {
    *   - `0` means infinite timeout.
    *   - `> 0` The time limit to use for the full execution of an operation.
    *
+   * If not set, the timeout is inherited from whatever the
+   * [[MongoDatabase.timeout MongoDatabase]] was resolved to.
+   *
    * @return the optional timeout duration
+   * @see [[withTimeout]]
    * @since 5.2
    */
   @Alpha(Array(Reason.CLIENT))
@@ -168,8 +172,12 @@ case class GridFSBucket(private val wrapped: JGridFSBucket) {
    * - `0` means infinite timeout.
    * - `> 0` The time limit to use for the full execution of an operation.
    *
+   * If not set, the timeout is inherited from whatever the
+   * [[MongoDatabase.timeout MongoDatabase]] was resolved to.
+   *
    * @param timeout the timeout, which must be greater than or equal to 0
    * @return a new GridFSBucket instance with the set time limit for operations
+   * @see [[timeout]]
    * @since 5.2
    */
   @Alpha(Array(Reason.CLIENT))

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

@@ -104,12 +104,16 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     * <p>If not set, the timeout is inherited from whatever the
+     * {@linkplain MongoDatabase#getTimeout MongoDatabase} was resolved to.
+     *
      *  <p>Note: 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 5.2
+     * @see #withTimeout
      */
     @Alpha(Reason.CLIENT)
     @Nullable
@@ -158,6 +162,9 @@ public interface GridFSBucket {
      *    <li>{@code > 0} The time limit to use for the full execution of an operation.</li>
      * </ul>
      *
+     * <p>If not set, the timeout is inherited from whatever the
+     * {@linkplain MongoDatabase#getTimeout MongoDatabase} was resolved to.
+     *
      *  <p>Note: This timeout does not limit socket writes, therefore there is a possibility that the
      *  operation might not be timed out when expected.
      *