diff -r 634d8e14c172 -r 34d7cc00f87a src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/WebSocket.java
--- a/src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/WebSocket.java Sun Nov 05 17:32:13 2017 +0000
+++ b/src/jdk.incubator.httpclient/share/classes/jdk/incubator/http/WebSocket.java Sun Nov 05 21:19:55 2017 +0000
@@ -192,8 +192,12 @@
*
{@link InterruptedException} -
* if the operation was interrupted
* {@link SecurityException} -
- * if a security manager is set, and the caller does not
- * have a {@link java.net.URLPermission} for the WebSocket URI
+ * If a security manager has been installed and it denies
+ * {@link java.net.URLPermission access} to the WebSocket URI,
+ * that was used to create this builder.
+ * Security checks
+ * contains more information relating to the security context
+ * in which the the listener is invoked.
* {@link IllegalArgumentException} -
* if any of the additional {@link #header(String, String)
* headers} are illegal;