/hg/icedtea-web: 2 new changesets
omajid at icedtea.classpath.org
omajid at icedtea.classpath.org
Fri Jan 24 07:10:50 PST 2014
changeset 4b70f2812899 in /hg/icedtea-web
details: http://icedtea.classpath.org/hg/icedtea-web?cmd=changeset;node=4b70f2812899
author: Omair Majid <omajid at redhat.com>
date: Fri Jan 24 10:05:12 2014 -0500
Support building against OpenJDK8
The OpenJDK8 javadoc parser is much more strict and raises
erorrs on marlformed html, incorrect parameter names and
incorrect throws declerations.
2014-01-23 Omair Majid <omajid at redhat.com>
* netx/net/sourceforge/jnlp/JNLPFile.java,
* netx/net/sourceforge/jnlp/NetxPanel.java,
* netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java,
* netx/net/sourceforge/jnlp/cache/CacheUtil.java,
* netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java,
* netx/net/sourceforge/jnlp/config/DirectoryValidator.java,
* netx/net/sourceforge/jnlp/config/Setting.java,
* netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java,
* netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java,
* netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java,
* netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java,
* netx/net/sourceforge/jnlp/security/SecurityDialogs.java,
* netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java,
* netx/net/sourceforge/jnlp/services/XSingleInstanceService.java,
* netx/net/sourceforge/jnlp/util/FileUtils.java,
* netx/net/sourceforge/jnlp/util/JarFile.java,
* netx/net/sourceforge/nanoxml/XMLElement.java,
* netx/net/sourceforge/nanoxml/XMLParseException.java,
* plugin/icedteanp/java/sun/applet/PluginStreamHandler.java: Fix incorrect
parameter names, throws declerations and malformed html in javadocs.
changeset 353717054f7e in /hg/icedtea-web
details: http://icedtea.classpath.org/hg/icedtea-web?cmd=changeset;node=353717054f7e
author: Omair Majid <omajid at redhat.com>
date: Fri Jan 24 10:08:57 2014 -0500
Support building against OpenJDK9
OpenJDK9 does not have a PermGen and does not accept PermGen
related flags. Remove them.
2014-01-23 Omair Majid <omajid at redhat.com>
* Makefile.am [ENABLE_DOCS] [JAVADOC_SUPPORTS_J_OPTIONS]:
Don't specify perm gen size.
diffstat:
ChangeLog | 28 ++
Makefile.am | 2 +-
netx/net/sourceforge/jnlp/JNLPFile.java | 10 +-
netx/net/sourceforge/jnlp/NetxPanel.java | 2 +-
netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java | 3 -
netx/net/sourceforge/jnlp/cache/CacheUtil.java | 2 +-
netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java | 4 +-
netx/net/sourceforge/jnlp/config/DirectoryValidator.java | 2 +
netx/net/sourceforge/jnlp/config/Setting.java | 2 +-
netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java | 2 +-
netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java | 1 -
netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java | 7 +-
netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java | 2 +-
netx/net/sourceforge/jnlp/security/SecurityDialogs.java | 2 +-
netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java | 2 +-
netx/net/sourceforge/jnlp/services/XSingleInstanceService.java | 4 +-
netx/net/sourceforge/jnlp/util/FileUtils.java | 5 +-
netx/net/sourceforge/jnlp/util/JarFile.java | 3 +-
netx/net/sourceforge/nanoxml/XMLElement.java | 140 ++++-----
netx/net/sourceforge/nanoxml/XMLParseException.java | 16 +-
plugin/icedteanp/java/sun/applet/PluginStreamHandler.java | 4 -
21 files changed, 131 insertions(+), 112 deletions(-)
diffs (truncated from 792 to 500 lines):
diff -r c125ee7b6759 -r 353717054f7e ChangeLog
--- a/ChangeLog Mon Jan 20 18:28:16 2014 +0100
+++ b/ChangeLog Fri Jan 24 10:08:57 2014 -0500
@@ -1,3 +1,31 @@
+2014-01-23 Omair Majid <omajid at redhat.com>
+
+ * Makefile.am [ENABLE_DOCS] [JAVADOC_SUPPORTS_J_OPTIONS]:
+ Don't specify perm gen size.
+
+2014-01-23 Omair Majid <omajid at redhat.com>
+
+ * netx/net/sourceforge/jnlp/JNLPFile.java,
+ * netx/net/sourceforge/jnlp/NetxPanel.java,
+ * netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java,
+ * netx/net/sourceforge/jnlp/cache/CacheUtil.java,
+ * netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java,
+ * netx/net/sourceforge/jnlp/config/DirectoryValidator.java,
+ * netx/net/sourceforge/jnlp/config/Setting.java,
+ * netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java,
+ * netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java,
+ * netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java,
+ * netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java,
+ * netx/net/sourceforge/jnlp/security/SecurityDialogs.java,
+ * netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java,
+ * netx/net/sourceforge/jnlp/services/XSingleInstanceService.java,
+ * netx/net/sourceforge/jnlp/util/FileUtils.java,
+ * netx/net/sourceforge/jnlp/util/JarFile.java,
+ * netx/net/sourceforge/nanoxml/XMLElement.java,
+ * netx/net/sourceforge/nanoxml/XMLParseException.java,
+ * plugin/icedteanp/java/sun/applet/PluginStreamHandler.java: Fix incorrect
+ parameter names, throws declerations and malformed html in javadocs.
+
2014-01-20 Jiri Vanek <jvanek at redhat.com>
Added Christmas splashscreen extension.
diff -r c125ee7b6759 -r 353717054f7e Makefile.am
--- a/Makefile.am Mon Jan 20 18:28:16 2014 +0100
+++ b/Makefile.am Fri Jan 24 10:08:57 2014 -0500
@@ -172,7 +172,7 @@
JAVADOC_OPTS=-use -keywords -encoding UTF-8 -splitIndex \
-bottom '<font size="-1"> <a href="http://icedtea.classpath.org/bugzilla">Submit a bug or feature</a></font>'
if JAVADOC_SUPPORTS_J_OPTIONS
-JAVADOC_MEM_OPTS=-J-Xmx1024m -J-Xms128m -J-XX:PermSize=32m -J-XX:MaxPermSize=160m
+JAVADOC_MEM_OPTS=-J-Xmx1024m -J-Xms128m
endif
endif
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/JNLPFile.java
--- a/netx/net/sourceforge/jnlp/JNLPFile.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/JNLPFile.java Fri Jan 24 10:08:57 2014 -0500
@@ -199,7 +199,7 @@
*
* @param location the location of the JNLP file
* @param version the version of the JNLP file
- * @param strict whether to enforce the spec when
+ * @param settings the {@link ParserSettings} to use when parsing the {@code location}
* @param policy the update policy
* @throws IOException if an IO exception occurred
* @throws ParseException if the JNLP file was invalid
@@ -264,7 +264,6 @@
/**
* 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,8 +276,7 @@
*
* @param input input stream of JNLP file.
* @param codebase codebase to use if not specified in JNLP file..
- * @param strict whether to enforce the spec rules
- * @throws IOException if an IO exception occurred
+ * @param settings the {@link ParserSettings} to use when parsing
* @throws ParseException if the JNLP file was invalid
*/
public JNLPFile(InputStream input, URL codebase, ParserSettings settings) throws ParseException {
@@ -665,9 +663,7 @@
*
* @param requested the local
* @param available the available locales
- * @param precision the depth with which to match locales. 1 checks only
- * language, 2 checks language and country, 3 checks language, country and
- * variant for matches. Passing 0 will always return true.
+ * @param matchLevel the detail with which to match locales.
* @return true if requested matches any of available, or if
* available is empty or null.
*/
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/NetxPanel.java
--- a/netx/net/sourceforge/jnlp/NetxPanel.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/NetxPanel.java Fri Jan 24 10:08:57 2014 -0500
@@ -42,7 +42,7 @@
* This panel calls into netx to run an applet, and pipes the display
* into a panel from the icedtea-web browser plugin.
*
- * @author Francis Kung <fkung at redhat.com>
+ * @author Francis Kung <fkung at redhat.com>
*/
public class NetxPanel extends AppletViewerPanel implements SplashController {
private final PluginParameters parameters;
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java
--- a/netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/cache/CacheLRUWrapper.java Fri Jan 24 10:08:57 2014 -0500
@@ -98,9 +98,6 @@
/**
* Returns an instance of the policy.
- *
- * @param propertiesFile
- * @return
*/
public static CacheLRUWrapper getInstance() {
return INSTANCE;
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/cache/CacheUtil.java
--- a/netx/net/sourceforge/jnlp/cache/CacheUtil.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/cache/CacheUtil.java Fri Jan 24 10:08:57 2014 -0500
@@ -368,7 +368,7 @@
/**
* Returns the parent directory of the cached resource.
- * @param path The path of the cached resource directory.
+ * @param filePath The path of the cached resource directory.
*/
public static String getCacheParentDirectory(String filePath) {
String path = filePath;
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java
--- a/netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/config/DeploymentConfiguration.java Fri Jan 24 10:08:57 2014 -0500
@@ -247,7 +247,7 @@
* Initialize this deployment configuration by reading configuration files.
* Generally, it will try to continue and ignore errors it finds (such as file not found).
*
- * @throws DeploymentException if it encounters a fatal error.
+ * @throws ConfigurationException if it encounters a fatal error.
*/
public void load() throws ConfigurationException {
load(true);
@@ -269,7 +269,7 @@
*
* @param fixIssues If true, fix issues that are discovered when reading configuration by
* resorting to the default values
- * @throws DeploymentException if it encounters a fatal error.
+ * @throws ConfigurationException if it encounters a fatal error.
*/
public void load(boolean fixIssues) throws ConfigurationException {
// make sure no state leaks if security check fails later on
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/config/DirectoryValidator.java
--- a/netx/net/sourceforge/jnlp/config/DirectoryValidator.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/config/DirectoryValidator.java Fri Jan 24 10:08:57 2014 -0500
@@ -216,12 +216,14 @@
/**
* Creates DirectoryValidator to ensure directories read from
* user (if any - default otherwise ) settings via keys:
+ * <ul>
* <li>KEY_USER_CACHE_DIR</li>
* <li>KEY_USER_PERSISTENCE_CACHE_DIR</li>
* <li>KEY_SYSTEM_CACHE_DIR</li>
* <li>KEY_USER_LOG_DIR</li>
* <li>KEY_USER_TMP_DIR</li>
* <li>KEY_USER_LOCKS_DIR</li>
+ * </ul>
*/
public DirectoryValidator() {
dirsToCheck = new ArrayList<File>(6);
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/config/Setting.java
--- a/netx/net/sourceforge/jnlp/config/Setting.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/config/Setting.java Fri Jan 24 10:08:57 2014 -0500
@@ -67,7 +67,7 @@
* @param defaultValue the default value of this setting. If this is not a
* recognized setting, use null.
* @param value the initial value of this setting
- * @param source the origin of the value (a file, or perhaps "<internal>")
+ * @param source the origin of the value (a file, or perhaps "{@code <internal>}")
*/
public Setting(String name, String description, boolean locked,
ValueValidator validator, T defaultValue, T value, String source) {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java
--- a/netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/controlpanel/AdvancedProxySettingsDialog.java Fri Jan 24 10:08:57 2014 -0500
@@ -37,7 +37,7 @@
/**
* This dialog provides a means for user to edit more of the proxy settings.
*
- * @author Andrew Su <asu at redhat.com, andrew.su at utoronto.ca>
+ * @author Andrew Su <asu at redhat.com, andrew.su at utoronto.ca>
*
*/
public class AdvancedProxySettingsDialog extends JDialog {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java
--- a/netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/runtime/JNLPClassLoader.java Fri Jan 24 10:08:57 2014 -0500
@@ -796,7 +796,6 @@
*
* @param jars Jars that are checked to see if they contain the main class
* @param name attribute to be found
- * @throws LaunchException Thrown if the signed JNLP file, within the main jar, fails to be verified or does not match
*/
public String checkForAttributeInJars(List<JARDesc> jars, Attributes.Name name) {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java
--- a/netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/runtime/JNLPRuntime.java Fri Jan 24 10:08:57 2014 -0500
@@ -684,7 +684,8 @@
}
/**
- * Indicate that netx is running by creating the {@link JNLPRuntime#INSTANCE_FILE} and
+ * Indicate that netx is running by creating the file corresponding to
+ * {@link DeploymentConfiguration#KEY_USER_NETX_RUNNING_FILE} and
* acquiring a shared lock on it
*/
public synchronized static void markNetxRunning() {
@@ -734,8 +735,8 @@
}
/**
- * Indicate that netx is stopped by releasing the shared lock on
- * {@link JNLPRuntime#INSTANCE_FILE}.
+ * Indicate that netx is stopped by releasing the shared lock on the file
+ * corresponding to {@link DeploymentConfiguration#KEY_USER_NETX_RUNNING_FILE}.
*/
private static void markNetxStopped() {
if (fileLock == null) {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java
--- a/netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/runtime/RhinoBasedPacEvaluator.java Fri Jan 24 10:08:57 2014 -0500
@@ -61,7 +61,7 @@
* Represents a Proxy Auto Config file. This object can be used to evaluate the
* proxy file to find the proxy for a given url.
*
- * @see "http://en.wikipedia.org/wiki/Proxy_auto-config#The_PAC_file"
+ * @see <a href="http://en.wikipedia.org/wiki/Proxy_auto-config#The_PAC_file">The PAC File</a>
*/
public class RhinoBasedPacEvaluator implements PacEvaluator {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/security/SecurityDialogs.java
--- a/netx/net/sourceforge/jnlp/security/SecurityDialogs.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/security/SecurityDialogs.java Fri Jan 24 10:08:57 2014 -0500
@@ -240,7 +240,7 @@
/**
* FIXME This is unused. Remove it?
- * @return (0, 1, 2) => (Yes, No, Cancel)
+ * @return (0, 1, 2) => (Yes, No, Cancel)
*/
public static int showAppletWarning() {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java
--- a/netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/security/VariableX509TrustManager.java Fri Jan 24 10:08:57 2014 -0500
@@ -200,7 +200,7 @@
* @param authType The auth type algorithm
* @param hostName The expected hostName that the server should have
* @param socket The SSLSocket in use (may be null)
- * @param ending The SSLEngine in use (may be null)
+ * @param engine The SSLEngine in use (may be null)
*/
public synchronized void checkTrustServer(X509Certificate[] chain,
String authType, String hostName,
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/services/XSingleInstanceService.java
--- a/netx/net/sourceforge/jnlp/services/XSingleInstanceService.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/services/XSingleInstanceService.java Fri Jan 24 10:08:57 2014 -0500
@@ -103,7 +103,7 @@
/**
* Initialize the new SingleInstanceService
*
- * @throws InstanceAlreadyExistsException if the instance already exists
+ * @throws InstanceExistsException if the instance already exists
*/
public void initializeSingleInstance() {
// this is called after the application has started. so safe to use
@@ -222,7 +222,7 @@
/**
* Add the specified SingleInstanceListener
*
- * @throws InstanceExistsException, which is likely to terminate the
+ * @throws InstanceExistsException which is likely to terminate the
* application but not guaranteed to
*/
public void addSingleInstanceListener(SingleInstanceListener sil) {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/util/FileUtils.java
--- a/netx/net/sourceforge/jnlp/util/FileUtils.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/util/FileUtils.java Fri Jan 24 10:08:57 2014 -0500
@@ -398,7 +398,8 @@
/**
* utility method which can read from any stream as one long String
*
- * @param input stream
+ * @param is stream
+ * @param encoding the encoding to use to convert the bytes from the stream
* @return stream as string
* @throws IOException if connection can't be established or resource does not exist
*/
@@ -424,7 +425,7 @@
/**
* utility method which can read from any stream as one long String
*
- * @param input stream
+ * @param is stream
* @return stream as string
* @throws IOException if connection can't be established or resource does not exist
*/
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/jnlp/util/JarFile.java
--- a/netx/net/sourceforge/jnlp/util/JarFile.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/jnlp/util/JarFile.java Fri Jan 24 10:08:57 2014 -0500
@@ -115,7 +115,8 @@
* So for our purposes we must insists on first record to be valid.
*
* @param file
- * @throws IOException, InvalidJarHeaderException
+ * @throws IOException
+ * @throws InvalidJarHeaderException
*/
public static void verifyZipHeader(File file) throws IOException {
if (!JNLPRuntime.isIgnoreHeaders()) {
diff -r c125ee7b6759 -r 353717054f7e netx/net/sourceforge/nanoxml/XMLElement.java
--- a/netx/net/sourceforge/nanoxml/XMLElement.java Mon Jan 20 18:28:16 2014 +0100
+++ b/netx/net/sourceforge/nanoxml/XMLElement.java Fri Jan 24 10:08:57 2014 -0500
@@ -43,11 +43,11 @@
* <DT><B>Parsing XML Data</B></DT>
* <DD>
* You can parse XML data using the following code:
- * <UL><CODE>
- * XMLElement xml = new XMLElement();<BR>
- * FileReader reader = new FileReader("filename.xml");<BR>
+ * <UL>{@code
+ * XMLElement xml = new XMLElement();
+ * FileReader reader = new FileReader("filename.xml");
* xml.parseFromReader(reader);
- * </CODE></UL></DD></DL>
+ * }</UL></DD></DL>
* <DL><DT><B>Retrieving Attributes</B></DT>
* <DD>
* You can enumerate the attributes of an element using the method
@@ -55,15 +55,15 @@
* The attribute values can be retrieved using the method
* {@link #getAttribute(java.lang.String) getAttribute}.
* The following example shows how to list the attributes of an element:
- * <UL><CODE>
- * XMLElement element = ...;<BR>
- * Enumeration enum = element.enumerateAttributeNames();<BR>
- * while (enum.hasMoreElements()) {<BR>
- * String key = (String) enum.nextElement();<BR>
- * String value = (String) element.getAttribute(key);<BR>
- * System.out.println(key + " = " + value);<BR>
+ * <UL>{@code
+ * XMLElement element = ...;
+ * Enumeration enum = element.enumerateAttributeNames();
+ * while (enum.hasMoreElements()) {
+ * String key = (String) enum.nextElement();
+ * String value = (String) element.getAttribute(key);
+ * System.out.println(key + " = " + value);
* }
- * </CODE></UL></DD></DL>
+ * }</UL></DD></DL>
* <DL><DT><B>Retrieving Child Elements</B></DT>
* <DD>
* You can enumerate the children of an element using
@@ -74,9 +74,7 @@
* <DL><DT><B>Elements Containing Character Data</B></DT>
* <DD>
* If an elements contains character data, like in the following example:
- * <UL><CODE>
- * <title>The Title</title>
- * </CODE></UL>
+ * <UL>{@code <title>The Title</title>}</UL>
* you can retrieve that data using the method
* {@link #getContent() getContent}.
* </DD></DL>
@@ -163,7 +161,7 @@
* The line number where the element starts.
*
* <dl><dt><b>Invariants:</b></dt><dd>
- * <ul><li><code>lineNr >= 0</code>
+ * <ul><li>{@code lineNr >= 0}
* </ul></dd></dl>
*/
private int lineNr;
@@ -215,17 +213,17 @@
/**
* Creates and initializes a new XML element.
* Calling the construction is equivalent to:
- * <ul><code>new XMLElement(new Hashtable(), false, true)
- * </code></ul>
+ * <ul><li><code>new XMLElement(new Hashtable(), false, true)
+ * </code></li></ul>
*
* <dl><dt><b>Postconditions:</b></dt><dd>
- * <ul><li>countChildren() => 0
- * <li>enumerateChildren() => empty enumeration
- * <li>enumeratePropertyNames() => empty enumeration
- * <li>getChildren() => empty vector
- * <li>getContent() => ""
- * <li>getLineNr() => 0
- * <li>getName() => null
+ * <ul><li>countChildren() => 0
+ * <li>enumerateChildren() => empty enumeration
+ * <li>enumeratePropertyNames() => empty enumeration
+ * <li>getChildren() => empty vector
+ * <li>getContent() => ""
+ * <li>getLineNr() => 0
+ * <li>getName() => null
* </ul></dd></dl>
*
*/
@@ -252,7 +250,7 @@
* <code>true</code> if the case of element and attribute names have
* to be ignored.
*
- * </dl><dl><dt><b>Preconditions:</b></dt><dd>
+ * <dl><dt><b>Preconditions:</b></dt><dd>
* <ul><li><code>entities != null</code>
* <li>if <code>fillBasicConversionTable == false</code>
* then <code>entities</code> contains at least the following
@@ -261,14 +259,14 @@
* </ul></dd></dl>
*
* <dl><dt><b>Postconditions:</b></dt><dd>
- * <ul><li>countChildren() => 0
- * <li>enumerateChildren() => empty enumeration
- * <li>enumeratePropertyNames() => empty enumeration
- * <li>getChildren() => empty vector
- * <li>getContent() => ""
- * <li>getLineNr() => 0
- * <li>getName() => null
- * </ul></dd></dl><dl>
+ * <ul><li>countChildren() => 0
+ * <li>enumerateChildren() => empty enumeration
+ * <li>enumeratePropertyNames() => empty enumeration
+ * <li>getChildren() => empty vector
+ * <li>getContent() => ""
+ * <li>getLineNr() => 0
+ * <li>getName() => null
+ * </ul></dd></dl>
*
*/
protected XMLElement(Hashtable<String, char[]> entities,
@@ -306,17 +304,17 @@
* @param child
* The child element to add.
*
- * </dl><dl><dt><b>Preconditions:</b></dt><dd>
+ * <dl><dt><b>Preconditions:</b></dt><dd>
* <ul><li><code>child != null</code>
* <li><code>child.getName() != null</code>
* <li><code>child</code> does not have a parent element
* </ul></dd></dl>
*
* <dl><dt><b>Postconditions:</b></dt><dd>
- * <ul><li>countChildren() => old.countChildren() + 1
- * <li>enumerateChildren() => old.enumerateChildren() + child
- * <li>getChildren() => old.enumerateChildren() + child
- * </ul></dd></dl><dl>
+ * <ul><li>countChildren() => old.countChildren() + 1
+ * <li>enumerateChildren() => old.enumerateChildren() + child
+ * <li>getChildren() => old.enumerateChildren() + child
+ * </ul></dd></dl>
*
*/
public void addChild(XMLElement child) {
@@ -331,7 +329,7 @@
* @param value
* The value of the attribute.
*
- * </dl><dl><dt><b>Preconditions:</b></dt><dd>
+ * <dl><dt><b>Preconditions:</b></dt><dd>
* <ul><li><code>name != null</code>
* <li><code>name</code> is a valid XML identifier
* <li><code>value != null</code>
@@ -339,9 +337,9 @@
*
* <dl><dt><b>Postconditions:</b></dt><dd>
* <ul><li>enumerateAttributeNames()
- * => old.enumerateAttributeNames() + name
- * <li>getAttribute(name) => value
- * </ul></dd></dl><dl>
+ * => old.enumerateAttributeNames() + name
+ * <li>getAttribute(name) => value
+ * </ul></dd></dl>
*
*/
public void setAttribute(String name,
@@ -356,7 +354,7 @@
* Returns the number of child elements of the element.
*
* <dl><dt><b>Postconditions:</b></dt><dd>
- * <ul><li><code>result >= 0</code>
+ * <ul><li>{@code result >= 0}
* </ul></dd></dl>
*
*/
@@ -402,7 +400,7 @@
* This method returns <code>0</code> there is no associated source data.
*
* <dl><dt><b>Postconditions:</b></dt><dd>
- * <ul><li><code>result >= 0</code>
+ * <ul><li>{@code result >= 0}
* </ul></dd></dl>
*/
public int getLineNr() {
More information about the distro-pkg-dev
mailing list