--- a/jdk/src/java.base/share/classes/java/net/URLClassLoader.java	Mon Nov 28 11:13:38 2016 -0500
+++ b/jdk/src/java.base/share/classes/java/net/URLClassLoader.java	Fri Dec 02 10:05:53 2016 -0800
@@ -72,6 +72,10 @@
  * <p>
  * The classes that are loaded are by default granted permission only to
  * access the URLs specified when the URLClassLoader was created.
+ * <p>
+ * This class loader supports the loading of classes from the contents of a
+ * <a href="../util/jar/JarFile.html#multirelease">multi-release</a> JAR file
+ * that is referred to by a given URL.
  *
  * @author  David Connelly
  * @since   1.2

--- a/jdk/src/java.base/share/classes/java/util/jar/JarFile.java	Mon Nov 28 11:13:38 2016 -0500
+++ b/jdk/src/java.base/share/classes/java/util/jar/JarFile.java	Fri Dec 02 10:05:53 2016 -0800
@@ -48,8 +48,8 @@
  * processing multi-release jar files.  The {@code Manifest} can be used
  * to specify meta-information about the jar file and its entries.
  *
- * <p>A multi-release jar file is a jar file that contains
- * a manifest with a main attribute named "Multi-Release",
+ * <p><a name="multirelease">A multi-release jar file</a> is a jar file that
+ * contains a manifest with a main attribute named "Multi-Release",
  * a set of "base" entries, some of which are public classes with public
  * or protected methods that comprise the public interface of the jar file,
  * and a set of "versioned" entries contained in subdirectories of the