/hg/icedtea-web: Javadoc, XHTML conformance, and formatting cleanup
gitne at icedtea.classpath.org
gitne at icedtea.classpath.org
Thu Jan 30 23:13:08 PST 2014
changeset 07e06846b07a in /hg/icedtea-web
details: http://icedtea.classpath.org/hg/icedtea-web?cmd=changeset;node=07e06846b07a
author: Jacob Wisor <gitne at gmx.de>
date: Fri Jan 31 08:11:43 2014 +0100
Javadoc, XHTML conformance, and formatting cleanup
diffstat:
ChangeLog | 8 +-
netx/net/sourceforge/jnlp/InformationDesc.java | 2 +-
netx/net/sourceforge/jnlp/JNLPFile.java | 31 +-
netx/net/sourceforge/jnlp/JNLPMatcher.java | 10 +-
netx/net/sourceforge/jnlp/Launcher.java | 14 +-
netx/net/sourceforge/jnlp/Parser.java | 24 +-
netx/net/sourceforge/jnlp/PluginParameters.java | 5 +-
netx/net/sourceforge/jnlp/ResourcesDesc.java | 2 +-
netx/net/sourceforge/jnlp/Version.java | 9 +-
netx/net/sourceforge/jnlp/browser/BrowserAwareProxySelector.java | 3 +
netx/net/sourceforge/jnlp/browser/FirefoxPreferencesParser.java | 7 +-
netx/net/sourceforge/jnlp/cache/CacheEntry.java | 2 +-
netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java | 4 +-
netx/net/sourceforge/jnlp/cache/CacheUtil.java | 24 +-
netx/net/sourceforge/jnlp/cache/DownloadIndicator.java | 11 +-
netx/net/sourceforge/jnlp/cache/IllegalResourceDescriptorException.java | 2 +-
netx/net/sourceforge/jnlp/cache/Resource.java | 9 +-
netx/net/sourceforge/jnlp/cache/ResourceTracker.java | 87 +-
netx/net/sourceforge/jnlp/cache/UpdatePolicy.java | 2 +-
netx/net/sourceforge/jnlp/cache/package-info.java | 36 +
netx/net/sourceforge/jnlp/cache/package.html | 28 -
netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java | 1 -
netx/net/sourceforge/jnlp/config/DirectoryValidator.java | 60 +-
netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsPane.java | 3 +-
netx/net/sourceforge/jnlp/controlpanel/CacheViewer.java | 4 +-
netx/net/sourceforge/jnlp/controlpanel/CommandLine.java | 8 +-
netx/net/sourceforge/jnlp/controlpanel/ControlPanel.java | 7 +-
netx/net/sourceforge/jnlp/event/package.html | 28 -
netx/net/sourceforge/jnlp/package-info.java | 48 +
netx/net/sourceforge/jnlp/package.html | 30 -
netx/net/sourceforge/jnlp/resources/Messages.properties | 4 +-
netx/net/sourceforge/jnlp/resources/Messages_cs.properties | 8 +-
netx/net/sourceforge/jnlp/resources/Messages_de.properties | 2 +-
netx/net/sourceforge/jnlp/resources/Messages_pl.properties | 2 +-
netx/net/sourceforge/jnlp/runtime/ApplicationInstance.java | 11 +-
netx/net/sourceforge/jnlp/runtime/Boot.java | 6 +-
netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java | 11 +-
netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java | 88 +-
netx/net/sourceforge/jnlp/runtime/JNLPSecurityManager.java | 23 +-
netx/net/sourceforge/jnlp/runtime/LocateJnlpClassLoader.java | 6 +-
netx/net/sourceforge/jnlp/runtime/ManageJnlpResources.java | 8 +-
netx/net/sourceforge/jnlp/runtime/package-info.java | 37 +
netx/net/sourceforge/jnlp/runtime/package.html | 29 -
netx/net/sourceforge/jnlp/security/AppVerifier.java | 1 -
netx/net/sourceforge/jnlp/security/KeyStores.java | 2 +-
netx/net/sourceforge/jnlp/security/SecurityDialogMessageHandler.java | 4 +
netx/net/sourceforge/jnlp/security/SecurityDialogs.java | 16 +-
netx/net/sourceforge/jnlp/security/UnsignedAppletTrustWarningPanel.java | 6 +-
netx/net/sourceforge/jnlp/security/appletextendedsecurity/UnsignedAppletActionStorage.java | 68 +-
netx/net/sourceforge/jnlp/services/ServiceUtil.java | 2 +-
netx/net/sourceforge/jnlp/services/XDownloadService.java | 5 +-
netx/net/sourceforge/jnlp/services/package-info.java | 37 +
netx/net/sourceforge/jnlp/services/package.html | 29 -
netx/net/sourceforge/jnlp/splashscreen/SplashUtils.java | 49 +-
netx/net/sourceforge/jnlp/splashscreen/impls/defaultsplashscreen2012/ErrorPainter.java | 4 +-
netx/net/sourceforge/jnlp/splashscreen/impls/defaultsplashscreen2012/TextOutlineRenderer.java | 2 +-
netx/net/sourceforge/jnlp/splashscreen/parts/JEditorPaneBasedExceptionDialog.java | 6 +-
netx/net/sourceforge/jnlp/tools/CertInformation.java | 21 +-
netx/net/sourceforge/jnlp/tools/JarCertVerifier.java | 1 -
netx/net/sourceforge/jnlp/tools/KeyStoreUtil.java | 2 +-
netx/net/sourceforge/jnlp/util/PropertiesFile.java | 2 +-
netx/net/sourceforge/jnlp/util/Reflect.java | 16 +-
netx/net/sourceforge/jnlp/util/WeakList.java | 2 +-
netx/net/sourceforge/jnlp/util/logging/ConsoleOutputPaneModel.java | 2 +-
netx/net/sourceforge/jnlp/util/logging/FileLog.java | 55 +-
netx/net/sourceforge/jnlp/util/replacements/CharacterDecoder.java | 50 +-
netx/net/sourceforge/jnlp/util/replacements/CharacterEncoder.java | 60 +-
netx/net/sourceforge/jnlp/util/ui/package-info.java | 17 +-
netx/net/sourceforge/nanoxml/XMLElement.java | 345 ++++-----
netx/net/sourceforge/nanoxml/XMLParseException.java | 19 +-
70 files changed, 810 insertions(+), 757 deletions(-)
diffs (truncated from 3667 to 500 lines):
diff -r 369823848b26 -r 07e06846b07a ChangeLog
--- a/ChangeLog Thu Jan 30 10:08:31 2014 -0500
+++ b/ChangeLog Fri Jan 31 08:11:43 2014 +0100
@@ -1,3 +1,7 @@
+2014-01-30 Jacob Wisor <gitne at gmx.de>
+
+ * Javadoc, XHTML conformance, and formatting cleanup
+
2014-01-30 Andrew Azores <aazores at redhat.com>
* NEWS: added entry for PolicyPanel
@@ -1896,7 +1900,7 @@
Jacob Wisor <gitne at excite.co.jp>
Added default, DE and PL localization's tweeks
- * /netx/net/sourceforge/jnlp/resources/Messages.properties:
+ * netx/net/sourceforge/jnlp/resources/Messages.properties:
* netx/net/sourceforge/jnlp/resources/Messages_de.properties:
* netx/net/sourceforge/jnlp/resources/Messages_pl.properties
@@ -2111,7 +2115,7 @@
Added polish localisation
* netx/net/sourceforge/jnlp/resources/Messages_de.properties
* netx/net/sourceforge/jnlp/resources/Messages.properties: minor fixes
- * /netx/net/sourceforge/jnlp/resources/Messages_pl.properties: new localization
+ * netx/net/sourceforge/jnlp/resources/Messages_pl.properties: new localization
nearly complete list of PL values
* tests/netx/unit/net/sourceforge/jnlp/resources/MessagesPropertiesTest.java
Added PL as known translation
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/InformationDesc.java
--- a/netx/net/sourceforge/jnlp/InformationDesc.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/InformationDesc.java Fri Jan 31 08:11:43 2014 +0100
@@ -21,7 +21,7 @@
import java.util.*;
/**
- * The information element.<p>
+ * The information element.
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.9 $
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/JNLPFile.java
--- a/netx/net/sourceforge/jnlp/JNLPFile.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/JNLPFile.java Fri Jan 31 08:11:43 2014 +0100
@@ -36,18 +36,21 @@
import net.sourceforge.jnlp.util.logging.OutputController;
/**
+ * <p>
* Provides methods to access the information in a Java Network
* Launching Protocol (JNLP) file. The Java Network Launching
* Protocol specifies in an XML file the information needed to
* load, cache, and run Java code over the network and in a secure
- * environment.<p>
- *
+ * environment.
+ * </p>
+ * <p>
* This class represents the overall information about a JNLP file
* from the jnlp element. Other information is accessed through
* objects that represent the elements of a JNLP file
* (information, resources, application-desc, etc). References to
* these objects are obtained by calling the getInformation,
- * getResources, getSecurity, etc methods.<p>
+ * getResources, getSecurity, etc methods.
+ * </p>
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.21 $
@@ -205,7 +208,7 @@
* @throws ParseException if the JNLP file was invalid
*/
public JNLPFile(URL location, Version version, ParserSettings settings, UpdatePolicy policy) throws IOException, ParseException {
- this(location, version, settings, policy, null);
+ this(location, version, settings, policy, null);
}
/**
@@ -264,6 +267,7 @@
/**
* Create a JNLPFile from an input stream.
*
+ * @throws IOException if an IO exception occurred
* @throws ParseException if the JNLP file was invalid
*/
public JNLPFile(InputStream input, ParserSettings settings) throws ParseException {
@@ -277,6 +281,7 @@
* @param input input stream of JNLP file.
* @param codebase codebase to use if not specified in JNLP file..
* @param settings the {@link ParserSettings} to use when parsing
+ * @throws IOException if an IO exception occurred
* @throws ParseException if the JNLP file was invalid
*/
public JNLPFile(InputStream input, URL codebase, ParserSettings settings) throws ParseException {
@@ -657,17 +662,19 @@
/**
* Returns whether a locale is matched by one of more other
- * locales. Only the non-empty language, country, and variant
+ * locales. Only the non-empty language, country, and variant
* codes are compared; for example, a requested locale of
* Locale("","","") would always return true.
*
- * @param requested the local
+ * @param requested the requested locale
* @param available the available locales
- * @param matchLevel the detail with which to match locales.
- * @return true if requested matches any of available, or if
- * available is empty or null.
+ * @param matchLevel the depth with which to match locales.
+ * @return {@code true} if {@code requested} matches any of {@code available}, or if
+ * {@code available} is empty or {@code null}.
+ * @see Locale
+ * @see Match
*/
- public boolean localeMatches(Locale requested, Locale available[], Match matchLevel) {
+ public boolean localeMatches(Locale requested, Locale[] available, Match matchLevel) {
if (matchLevel == Match.GENERALIZED)
return available == null || available.length == 0;
@@ -730,9 +737,7 @@
* Initialize the JNLPFile fields. Private because it's called
* from the constructor.
*
- * @param root the root node
- * @param settings the parser settings to use while parsing the file
- * @param location the file location or null
+ * @param location the file location or {@code null}
*/
private void parse(InputStream input, URL location, URL forceCodebase) throws ParseException {
try {
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/JNLPMatcher.java
--- a/netx/net/sourceforge/jnlp/JNLPMatcher.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/JNLPMatcher.java Fri Jan 31 08:11:43 2014 +0100
@@ -203,14 +203,12 @@
}
/**
- * Compares attributes of two Nodes regardless of order
+ * Compares attributes of two {@link Node Nodes} regardless of order
*
- * @param appTemplateNode
- * signed application or template's Node with attributes
- * @param launchJNLPNode
- * launching JNLP file's Node with attributes
+ * @param templateNode signed application or template's {@link Node} with attributes
+ * @param launchNode launching JNLP file's {@link Node} with attributes
*
- * @return true if both Nodes have 'matched' attributes, otherwise false
+ * @return {@code true} if both {@link Node Nodes} have 'matched' attributes, otherwise {@code false}
*/
private boolean matchAttributes(Node templateNode, Node launchNode) {
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/Launcher.java
--- a/netx/net/sourceforge/jnlp/Launcher.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/Launcher.java Fri Jan 31 08:11:43 2014 +0100
@@ -50,13 +50,14 @@
import sun.awt.SunToolkit;
/**
- * Launches JNLPFiles either in the foreground or background.<p>
- *
+ * Launches JNLPFiles either in the foreground or background.
+ * <p>
* An optional LaunchHandler can be specified that is notified of
* warning and error condition while launching and that indicates
* whether a launch may proceed after a warning has occurred. If
* specified, the LaunchHandler is notified regardless of whether
- * the file is launched in the foreground or background.<p>
+ * the file is launched in the foreground or background.
+ * </p>
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.22 $
@@ -597,15 +598,16 @@
/**
* Launches a JNLP applet. This method should be called from a
- * thread in the application's thread group.<p>
- *
+ * thread in the application's thread group.
+ * <p>
* The enableCodeBase parameter adds the applet's codebase to
* the locations searched for resources and classes. This can
* slow down the applet loading but allows browser-style applets
* that don't use JAR files exclusively to be run from a applet
* JNLP file. If the applet JNLP file does not specify any
* resources then the code base will be enabled regardless of
- * the specified value.<p>
+ * the specified value.
+ * </p>
*
* @param file the JNLP file
* @param enableCodeBase whether to add the codebase URL to the classloader
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/Parser.java
--- a/netx/net/sourceforge/jnlp/Parser.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/Parser.java Fri Jan 31 08:11:43 2014 +0100
@@ -94,14 +94,14 @@
private boolean allowExtensions; // true if extensions to JNLP spec are ok
/**
- * Create a parser for the JNLP file. If the location
+ * Create a parser for the JNLP file. If the location
* parameters is not null it is used as the default codebase
* (does not override value of jnlp element's href
- * attribute).<p>
- *
+ * attribute).
+ * <p>
* The root node may be normalized as a side effect of this
* constructor.
- *
+ * </p>
* @param file the (uninitialized) file reference
* @param base if codebase is not specified, a default base for relative URLs
* @param root the root node
@@ -113,14 +113,14 @@
}
/**
- * Create a parser for the JNLP file. If the location
+ * Create a parser for the JNLP file. If the location
* parameters is not null it is used as the default codebase
* (does not override value of jnlp element's href
- * attribute).<p>
- *
+ * attribute).
+ * <p>
* The root node may be normalized as a side effect of this
* constructor.
- *
+ * </p>
* @param file the (uninitialized) file reference
* @param base if codebase is not specified, a default base for relative URLs
* @param root the root node
@@ -914,9 +914,9 @@
}
/**
- * Returns a Locale from a single locale.
+ * Returns a {@link Locale} from a single locale.
*
- * @param locale the locale string
+ * @param localeStr the locale string
*/
public Locale getLocale(String localeStr) {
if (localeStr.length() < 2)
@@ -1048,9 +1048,9 @@
/**
* Returns a URL object from a href string relative to the
- * code base. If the href denotes a relative URL, it must
+ * code base. If the href denotes a relative URL, it must
* reference a location that is a subdirectory of the
- * codebase.<p>
+ * codebase.
*
* @param node the node
* @param name the attribute containing an href
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/PluginParameters.java
--- a/netx/net/sourceforge/jnlp/PluginParameters.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/PluginParameters.java Fri Jan 31 08:11:43 2014 +0100
@@ -192,8 +192,7 @@
* Creates the underlying hash table with the proper overrides. Ensure all
* keys are lowercase consistently.
*
- * @param params
- * the properties, before parameter aliasing rules.
+ * @param rawParams the properties, before parameter aliasing rules.
* @return the resulting parameter table
*/
static Hashtable<String, String> createParameterTable(
@@ -235,4 +234,4 @@
public String toString() {
return parameters.toString();
}
-}
\ No newline at end of file
+}
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/ResourcesDesc.java
--- a/netx/net/sourceforge/jnlp/ResourcesDesc.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/ResourcesDesc.java Fri Jan 31 08:11:43 2014 +0100
@@ -19,7 +19,7 @@
import java.util.*;
/**
- * The resources element.<p>
+ * The resources element.
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.7 $
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/Version.java
--- a/netx/net/sourceforge/jnlp/Version.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/Version.java Fri Jan 31 08:11:43 2014 +0100
@@ -19,18 +19,21 @@
import java.util.*;
/**
+ * <p>
* A JNLP Version string in the form "1.2-3_abc" followed by an
* optional + (includes all later versions) or * (matches any
* suffixes on versions). More than one version can be included
- * in a string by separating them with spaces.<p>
- *
+ * in a string by separating them with spaces.
+ * </p>
+ * <p>
* Version strings are divided by "._-" charecters into parts.
* These parts are compared numerically if they can be parsed as
* integers or lexographically as strings otherwise. If the
* number of parts is different between two version strings then
* the smaller one is padded with zero or the empty string. Note
* that the padding in this version means that 1.2+ matches
- * 1.4.0-beta1, but may not in future versions.<p>
+ * 1.4.0-beta1, but may not in future versions.
+ * </p>
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.5 $
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/browser/BrowserAwareProxySelector.java
--- a/netx/net/sourceforge/jnlp/browser/BrowserAwareProxySelector.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/browser/BrowserAwareProxySelector.java Fri Jan 31 08:11:43 2014 +0100
@@ -170,12 +170,15 @@
}
/**
+ * <p>
* The main entry point for {@link BrowserAwareProxySelector}. Based on
* the browser settings, determines proxy information for a given URI.
+ * </p>
* <p>
* The appropriate proxy may be determined by reading static information
* from the browser's preferences file, or it may be computed dynamically,
* by, for example, running javascript code.
+ * </p>
*/
@Override
protected List<Proxy> getFromBrowser(URI uri) {
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/browser/FirefoxPreferencesParser.java
--- a/netx/net/sourceforge/jnlp/browser/FirefoxPreferencesParser.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/browser/FirefoxPreferencesParser.java Fri Jan 31 08:11:43 2014 +0100
@@ -48,16 +48,17 @@
import net.sourceforge.jnlp.util.logging.OutputController;
/**
+ * <p>
* A parser for Firefox's preferences file. It can 'parse' Firefox's
* preferences file and expose the prefrences in a simple to use format.
- * <p>
+ * </p>
* Sample usage:
- * <pre>
+ * <pre><code>
* FirefoxPreferencesParser p = new FirefoxPreferencesParser(prefsFile);
* p.parse();
* Map<String,String> prefs = p.getPreferences();
* System.out.println("blink allowed: " + prefs.get("browser.blink_allowed"));
- * </pre>
+ * </code></pre>
*/
public final class FirefoxPreferencesParser {
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/cache/CacheEntry.java
--- a/netx/net/sourceforge/jnlp/cache/CacheEntry.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/cache/CacheEntry.java Fri Jan 31 08:11:43 2014 +0100
@@ -27,7 +27,7 @@
import net.sourceforge.jnlp.util.*;
/**
- * Describes an entry in the cache.<p>
+ * Describes an entry in the cache.
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.10 $
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java
--- a/netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java Fri Jan 31 08:11:43 2014 +0100
@@ -60,7 +60,7 @@
* This class helps maintain the ordering of most recently use items across
* multiple jvm instances.
*
- * @author Andrew Su (asu at redhat.com, andrew.su at utoronto.ca)
+ * @author <a href="mailto:Andrew%20Su%20<asu at redhat.com>">Andrew Su (asu at redhat.com</a>, <a href="mailto:Andrew%20Su%20<andrew.su at utoronto.ca>">andrew.su at utoronto.ca)</a>
*
*/
public enum CacheLRUWrapper {
@@ -98,6 +98,8 @@
/**
* Returns an instance of the policy.
+ *
+ * @return an instance of the policy
*/
public static CacheLRUWrapper getInstance() {
return INSTANCE;
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/cache/CacheUtil.java
--- a/netx/net/sourceforge/jnlp/cache/CacheUtil.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/cache/CacheUtil.java Fri Jan 31 08:11:43 2014 +0100
@@ -54,7 +54,7 @@
/**
* Provides static methods to interact with the cache, download
- * indicator, and other utility methods.<p>
+ * indicator, and other utility methods.
*
* @author <a href="mailto:jmaxwell at users.sourceforge.net">Jon A. Maxwell (JAM)</a> - initial author
* @version $Revision: 1.17 $
@@ -68,7 +68,7 @@
/**
* Compares a URL using string compare of its protocol, host,
- * port, path, query, and anchor. This method avoids the host
+ * port, path, query, and anchor. This method avoids the host
* name lookup that URL.equals does for http: protocol URLs.
* It may not return the same value as the URL.equals method
* (different hostnames that resolve to the same IP address,
@@ -111,12 +111,12 @@
}
/**
* Caches a resource and returns a URL for it in the cache;
- * blocks until resource is cached. If the resource location is
+ * blocks until resource is cached. If the resource location is
* not cacheable (points to a local file, etc) then the original
- * URL is returned.<p>
+ * URL is returned.
*
* @param location location of the resource
- * @param version the version, or null
+ * @param version the version, or {@code null}
* @return either the location in the cache or the original location
*/
public static URL getCachedResource(URL location, Version version, UpdatePolicy policy) {
@@ -132,7 +132,7 @@
}
/**
- * Compare strings that can be null.
+ * Compare strings that can be {@code null}.
*/
private static boolean compare(String s1, String s2, boolean ignore) {
if (s1 == s2)
@@ -148,7 +148,7 @@
/**
* Returns the Permission object necessary to access the
- * resource, or null if no permission is needed.
+ * resource, or {@code null} if no permission is needed.
*/
public static Permission getReadPermission(URL location, Version version) {
if (CacheUtil.isCacheable(location, version)) {
@@ -230,9 +230,9 @@
* cache and it is up to date. This method may not return
* immediately.
*
- * @param source the source URL
+ * @param source the source {@link URL}
* @param version the versions to check for
- * @param connection a connection to the URL, or null
+ * @param connection a connection to the {@link URL}, or {@code null}
* @return whether the cache contains the version
* @throws IllegalArgumentException if the source is not cacheable
*/
@@ -304,9 +304,9 @@
* not download the resource. The latest version of the
* resource that matches the specified version will be returned.
*
- * @param source the source URL
+ * @param source the source {@link URL}
* @param version the version id of the local file
- * @return the file location in the cache, or null if no versions cached
+ * @return the file location in the cache, or {@code null} if no versions cached
* @throws IllegalArgumentException if the source is not cacheable
*/
public static File getCacheFile(URL source, Version version) {
@@ -336,7 +336,7 @@
* This will return a File pointing to the location of cache item.
*
* @param urlPath Path of cache item within cache directory.
- * @return File if we have searched before, null otherwise.
+ * @return File if we have searched before, {@code null} otherwise.
*/
private static File getCacheFileIfExist(File urlPath) {
synchronized (lruHandler) {
diff -r 369823848b26 -r 07e06846b07a netx/net/sourceforge/jnlp/cache/DownloadIndicator.java
--- a/netx/net/sourceforge/jnlp/cache/DownloadIndicator.java Thu Jan 30 10:08:31 2014 -0500
+++ b/netx/net/sourceforge/jnlp/cache/DownloadIndicator.java Fri Jan 31 08:11:43 2014 +0100
@@ -32,13 +32,14 @@
/**
* Return a download service listener that displays the progress
- * of downloading resources. Update messages may be reported
- * for URLs that are not included initially.<p>
- *
+ * of downloading resources. Update messages may be reported
+ * for URLs that are not included initially.
+ * <p>
* Progress messages are sent as if the DownloadServiceListener
- * were listening to a DownloadService request. The listener
+ * were listening to a DownloadService request. The listener
* will receive progress messages from time to time during the
More information about the distro-pkg-dev
mailing list