diff --git a/src/main/java/io/lettuce/core/support/BoundedPoolConfig.java b/src/main/java/io/lettuce/core/support/BoundedPoolConfig.java
index 95d7c18793..d14582d4b2 100644
--- a/src/main/java/io/lettuce/core/support/BoundedPoolConfig.java
+++ b/src/main/java/io/lettuce/core/support/BoundedPoolConfig.java
@@ -153,7 +153,8 @@ public Builder testOnRelease(boolean testOnRelease) {
 
         /**
          * Configures the maximum number of objects that can be allocated by the pool (checked out to clients, or idle awaiting
-         * checkout) at a given time.
+         * checkout) at a given time. When negative, there is no limit to the number of objects that can be managed by
+         * the pool at one time.
          *
          * @param maxTotal maximum number of objects that can be allocated by the pool.
          * @return {@code this} {@link Builder}.
@@ -181,10 +182,10 @@ public Builder maxIdle(int maxIdle) {
         }
 
         /**
-         * Configures the maximum number of objects that can be allocated by the pool (checked out to clients, or idle awaiting
-         * checkout) at a given time.
+         * Configures the minimum number of idle objects to maintain in the pool. If this is the case, an attempt is
+         * made to ensure that the pool has the required minimum number of instances during idle object eviction runs.
          *
-         * @param minIdle maximum number of objects that can be allocated by the pool.
+         * @param minIdle minimum number of idle objects to maintain in the pool.
          * @return {@code this} {@link Builder}.
          */
         public Builder minIdle(int minIdle) {