--- a/jdk/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java	Sat Oct 10 17:27:10 2015 +0100
+++ b/jdk/src/java.base/share/classes/java/net/URLStreamHandlerFactory.java	Sat Oct 10 17:30:04 2015 +0100
@@ -28,9 +28,9 @@
 /**
  * This interface defines a factory for {@code URL} stream
  * protocol handlers.
- * <p>
- * It is used by the {@code URL} class to create a
- * {@code URLStreamHandler} for a specific protocol.
+ *
+ * <p> A URL stream handler factory is used as specified in the
+ * {@linkplain java.net.URL#URL(String,String,int,String) URL constructor}.
  *
  * @author  Arthur van Hoff
  * @see     java.net.URL

--- a/jdk/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java	Sat Oct 10 17:27:10 2015 +0100
+++ b/jdk/src/java.base/share/classes/java/net/spi/URLStreamHandlerProvider.java	Sat Oct 10 17:30:04 2015 +0100
@@ -41,6 +41,9 @@
  * fully-qualified concrete URL stream handler provider class names, one per
  * line.
  *
+ * <p> URL stream handler providers are located at runtime, as specified in the
+ * {@linkplain java.net.URL#URL(String,String,int,String) URL constructor}.
+ *
  * @since 1.9
  */
 public abstract class URLStreamHandlerProvider