8165782: java.util.jar.JarFile.runtimeVersion() spec needs clarification

Reviewed-by: mchung, alanb
This commit is contained in:
Paul Sandoz 2016-11-08 12:36:13 -08:00
parent a13cbb364c
commit 060ce7c739

View File

@ -192,9 +192,10 @@ class JarFile extends ZipFile {
public static final String MANIFEST_NAME = META_INF + "MANIFEST.MF"; public static final String MANIFEST_NAME = META_INF + "MANIFEST.MF";
/** /**
* The version that represents the unversioned configuration of a multi-release jar file. * Returns the version that represents the unversioned configuration of a
* multi-release jar file.
* *
* @return Runtime.Version that represents the unversioned configuration * @return the version that represents the unversioned configuration
* *
* @since 9 * @since 9
*/ */
@ -203,13 +204,16 @@ class JarFile extends ZipFile {
} }
/** /**
* The version that represents the effective runtime versioned configuration of a * Returns the version that represents the effective runtime versioned
* multi-release jar file. In most cases, {@code runtimeVersion()} is equal to * configuration of a multi-release jar file.
* {@code Runtime.version()}. However, if the {@code jdk.util.jar.version} property is set, * <p>
* {@code runtimeVersion()} is derived from that property and may not be equal to * By default the major version number of the returned {@code Version} will
* {@code Runtime.version()}. * be equal to the major version number of {@code Runtime.version()}.
* However, if the {@code jdk.util.jar.version} property is set, the
* returned {@code Version} is derived from that property and major version
* numbers may not be equal.
* *
* @return Runtime.Version that represents the runtime versioned configuration * @return the version that represents the runtime versioned configuration
* *
* @since 9 * @since 9
*/ */