showuon commented on a change in pull request #11627:
URL: https://github.com/apache/kafka/pull/11627#discussion_r777394827



##########
File path: 
clients/src/main/java/org/apache/kafka/clients/CommonClientConfigs.java
##########
@@ -70,17 +70,34 @@
     public static final String CLIENT_RACK_DOC = "A rack identifier for this 
client. This can be any string value which indicates where this client is 
physically located. It corresponds with the broker config 'broker.rack'";
 
     public static final String RECONNECT_BACKOFF_MS_CONFIG = 
"reconnect.backoff.ms";
-    public static final String RECONNECT_BACKOFF_MS_DOC = "The base amount of 
time to wait before attempting to reconnect to a given host. This avoids 
repeatedly connecting to a host in a tight loop. This backoff applies to all 
connection attempts by the client to a broker.";
+    public static final String RECONNECT_BACKOFF_MS_DOC = "The base amount of 
time to wait before attempting to reconnect to a given host. " +
+        "This avoids repeatedly connecting to a host in a tight loop. This 
backoff applies to all connection attempts by the client to a broker. " +
+        "This value is the initial backoff value and will increase 
exponentially for each consecutive connection failure, up to the 
<code>reconnect.backoff.max.ms</code> value.";

Review comment:
       Add the last sentence to mention this is the initial backoff value and 
will increase exponentially up to `reconnect.backoff.max.ms`.
   
   Same as below `retry.backoff.ms` and `socket.connection.setup.timeout.ms`




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: jira-unsubscr...@kafka.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


Reply via email to