diff --git a/jetty-server/src/main/java/org/eclipse/jetty/server/HttpConfiguration.java b/jetty-server/src/main/java/org/eclipse/jetty/server/HttpConfiguration.java
index 430d299073e..b953a1b584d 100644
--- a/jetty-server/src/main/java/org/eclipse/jetty/server/HttpConfiguration.java
+++ b/jetty-server/src/main/java/org/eclipse/jetty/server/HttpConfiguration.java
@@ -234,7 +234,8 @@ public class HttpConfiguration
     /**
      * <p>This timeout is in addition to the {@link Connector#getIdleTimeout()}, and applies
      * to the total operation (as opposed to the idle timeout that applies to the time no 
-     * data is being sent).</p>
+     * data is being sent). This applies only to blocking operations and does not affect
+     * asynchronous read and write.</p>
      *
      * @return -1, for no blocking timeout (default), 0 for a blocking timeout equal to the 
      * idle timeout; &gt;0 for a timeout in ms applied to the total blocking operation.
@@ -248,7 +249,8 @@ public class HttpConfiguration
     /**
      * <p>This timeout is in addition to the {@link Connector#getIdleTimeout()}, and applies
      * to the total operation (as opposed to the idle timeout that applies to the time no 
-     * data is being sent).</p>
+     * data is being sent).This applies only to blocking operations and does not affect
+     * asynchronous read and write.</p>
      *
      * @param blockingTimeout -1, for no blocking timeout (default), 0 for a blocking timeout equal to the 
      * idle timeout; &gt;0 for a timeout in ms applied to the total blocking operation.