--- a/src/java.net.http/share/classes/jdk/internal/net/http/HttpConnection.java	Wed Feb 14 17:02:56 2018 +0000
+++ b/src/java.net.http/share/classes/jdk/internal/net/http/HttpConnection.java	Wed Feb 14 17:35:42 2018 +0000
@@ -119,7 +119,11 @@
     /** Tells whether, or not, this connection is secure ( over SSL ) */
     abstract boolean isSecure();
 
-    /** Tells whether, or not, this connection is proxied. */
+    /**
+     * Tells whether, or not, this connection is proxied.
+     * Returns true for tunnel connections, or clear connection to
+     * any host through proxy.
+     */
     abstract boolean isProxied();
 
     /** Tells whether, or not, this connection is open. */