diff -r 3c2e826aa5ea -r d83f50188ca9 jdk/src/java.base/share/classes/sun/misc/ExtensionDependency.java --- a/jdk/src/java.base/share/classes/sun/misc/ExtensionDependency.java Tue May 19 10:05:02 2015 +0200 +++ b/jdk/src/java.base/share/classes/sun/misc/ExtensionDependency.java Tue May 19 16:04:14 2015 +0400 @@ -45,26 +45,26 @@ import sun.net.www.ParseUtil; /** - *
* This class checks dependent extensions a particular jar file may have * declared through its manifest attributes. - *
+ ** Jar file declared dependent extensions through the extension-list * attribute. The extension-list contains a list of keys used to * fetch the other attributes describing the required extension. * If key is the extension key declared in the extension-list * attribute, the following describing attribute can be found in - * the manifest : - * key-Extension-Name: (Specification package name) - * key-Specification-Version: (Specification-Version) - * key-Implementation-Version: (Implementation-Version) - * key-Implementation-Vendor-Id: (Imlementation-Vendor-Id) - * key-Implementation-Version: (Implementation version) - * key-Implementation-URL: (URL to download the requested extension) + * the manifest: + *
* This class also maintain versioning consistency of installed * extensions dependencies declared in jar file manifest. - *
* * @deprecated this class will be removed in a future release. * @author Jerome Dochez @@ -76,10 +76,9 @@ private static Vector* Register an ExtensionInstallationProvider. The provider is responsible * for handling the installation (upgrade) of any missing extensions. - *
+ * * @param eip ExtensionInstallationProvider implementation */ public synchronized static void addExtensionInstallationProvider @@ -92,9 +91,7 @@ } /** - ** Unregister a previously installed installation provider - *
*/ public synchronized static void removeExtensionInstallationProvider (ExtensionInstallationProvider eip) @@ -103,10 +100,9 @@ } /** - ** Checks the dependencies of the jar file on installed extension. - *
- * @param jarFile containing the attriutes declaring the dependencies + * + * @param jar containing the attributes declaring the dependencies */ public static boolean checkExtensionsDependencies(JarFile jar) { @@ -182,9 +178,8 @@ /* - ** Check that a particular dependency on an extension is satisfied. - *
+ * * @param extensionName is the key used for the attributes in the manifest * @param attr is the attributes of the manifest file * @@ -204,10 +199,9 @@ } /* - ** Check if a particular extension is part of the currently installed * extensions. - *
+ * * @param extensionName is the key for the attributes in the manifest * @param attr is the attributes of the manifest * @@ -262,11 +256,9 @@ } /* - ** Check if the requested extension described by the attributes * in the manifest under the key extensionName is compatible with * the jar file. - *
* * @param extensionName key in the attribute list * @param attr manifest file attributes @@ -337,10 +329,8 @@ } /* - ** An required extension is missing, if an ExtensionInstallationProvider is * registered, delegate the installation of that particular extension to it. - *
* * @param reqInfo Missing extension information * @param instInfo Older installed version information @@ -380,11 +370,9 @@ } /** - ** Checks if the extension, that is specified in the extension-list in * the applet jar manifest, is already installed (i.e. exists in the * extension directory). - *
* * @param extensionName extension name in the extension-list * @@ -428,9 +416,7 @@ } /** - ** @return the java.ext.dirs property as a list of directory - *
*/ private static File[] getExtDirs() { String s = java.security.AccessController.doPrivileged( @@ -456,9 +442,8 @@ } /* - ** Scan the directories and return all files installed in those - *
+ * * @param dirs list of directories to scan * * @return the list of files installed in all the directories @@ -483,9 +468,7 @@ } /* - ** @return the list of installed extensions jar files - *
*/ private File[] getInstalledExtensions() throws IOException { return AccessController.doPrivileged( @@ -503,9 +486,7 @@ } /* - ** Add the newly installed jar file to the extension class loader. - *
* * @param cl the current installed extension class loader *