--- a/src/java.base/share/classes/java/net/CookieHandler.java	Fri Mar 16 12:32:34 2018 +0000
+++ b/src/java.base/share/classes/java/net/CookieHandler.java	Fri Mar 16 12:57:42 2018 +0000
@@ -36,9 +36,9 @@
  * handler. The HTTP state management mechanism specifies a way to
  * create a stateful session with HTTP requests and responses.
  *
- * <p>A system-wide CookieHandler that to used by the HTTP protocol
- * handler can be registered by doing a
- * CookieHandler.setDefault(CookieHandler). The currently registered
+ * <p> A system-wide CookieHandler to be used by the {@linkplain
+ * HttpURLConnection HTTP URL stream protocol handler} can be registered by
+ * doing a CookieHandler.setDefault(CookieHandler). The currently registered
  * CookieHandler can be retrieved by calling
  * CookieHandler.getDefault().
  *

--- a/src/java.base/share/classes/java/net/doc-files/net-properties.html	Fri Mar 16 12:32:34 2018 +0000
+++ b/src/java.base/share/classes/java/net/doc-files/net-properties.html	Fri Mar 16 12:57:42 2018 +0000
@@ -156,7 +156,7 @@
 	checked only once at startup.</P>
 </UL>
 <a id="MiscHTTP"></a>
-<H2>Misc HTTP properties</H2>
+<H2>Misc HTTP URL stream protocol handler properties</H2>
 <UL>
 	<LI><P><B>http.agent</B> (default: &ldquo;Java/&lt;version&gt;&rdquo;)<BR>
 	Defines the string sent in the User-Agent request header in http

--- a/src/java.base/share/classes/java/net/package-info.java	Fri Mar 16 12:32:34 2018 +0000
+++ b/src/java.base/share/classes/java/net/package-info.java	Fri Mar 16 12:57:42 2018 +0000
@@ -121,8 +121,8 @@
  *            underlying protocol handlers like http or https.</li>
  *       <li>{@link java.net.HttpURLConnection} is a subclass of URLConnection
  *            and provides some additional functionalities specific to the
- *            HTTP protocol. This API has been superceded by the newer
-              HTTP client API described in the previous section.</li>
+ *            HTTP protocol. This API has been superseded by the newer
+ *            {@linkplain java.net.http HTTP Client API}.</li>
  * </ul>
  * <p>The recommended usage is to use {@link java.net.URI} to identify
  *    resources, then convert it into a {@link java.net.URL} when it is time to