--- a/jdk/src/java.base/share/classes/java/util/jar/JarFile.java	Tue Nov 08 12:36:13 2016 -0800
+++ b/jdk/src/java.base/share/classes/java/util/jar/JarFile.java	Tue Nov 08 12:36:21 2016 -0800
@@ -339,6 +339,10 @@
 
     /**
      * Returns the maximum version used when searching for versioned entries.
+     * <p>
+     * If this {@code JarFile} is not a multi-release jar file or is not
+     * configured to be processed as such, then the version returned will be the
+     * same as that returned from {@link #baseVersion()}.
      *
      * @return the maximum version
      * @since 9