Bug 543933 - Build javadocs with Java 11I20190215-0630I20190215-0055I20190214-1800

Fix javadoc warnings catched by Java 11 tool with XDoclint:html.

Change-Id: I99061cad4e8a9e3eb18bfc97143fa893715a58f8
Signed-off-by: Alexander Kurtakov <akurtako@redhat.com>

5 files changed, 40 insertions, 29 deletions

diff --git a/org.eclipse.core.variables/META-INF/MANIFEST.MF b/org.eclipse.core.variables/META-INF/MANIFEST.MF
index 93be34167..7b3e2de4c 100644
--- a/org.eclipse.core.variables/META-INF/MANIFEST.MF
+++ b/org.eclipse.core.variables/META-INF/MANIFEST.MF
@@ -2,7 +2,7 @@ Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: %pluginName
 Bundle-SymbolicName: org.eclipse.core.variables; singleton:=true
-Bundle-Version: 3.4.300.qualifier
+Bundle-Version: 3.4.400.qualifier
 Bundle-Activator: org.eclipse.core.variables.VariablesPlugin
 Bundle-Vendor: %providerName
 Bundle-Localization: plugin
diff --git a/org.eclipse.core.variables/pom.xml b/org.eclipse.core.variables/pom.xml
index 1cd8996f2..63fa0a644 100644
--- a/org.eclipse.core.variables/pom.xml
+++ b/org.eclipse.core.variables/pom.xml
@@ -18,6 +18,6 @@
   </parent>
   <groupId>org.eclipse.core</groupId>
   <artifactId>org.eclipse.core.variables</artifactId>
-  <version>3.4.300-SNAPSHOT</version>
+  <version>3.4.400-SNAPSHOT</version>
   <packaging>eclipse-plugin</packaging>
 </project>
diff --git a/org.eclipse.core.variables/src/org/eclipse/core/variables/IDynamicVariable.java b/org.eclipse.core.variables/src/org/eclipse/core/variables/IDynamicVariable.java
index 7a8c2ac67..80efe9b58 100644
--- a/org.eclipse.core.variables/src/org/eclipse/core/variables/IDynamicVariable.java
+++ b/org.eclipse.core.variables/src/org/eclipse/core/variables/IDynamicVariable.java
@@ -16,11 +16,14 @@ package org.eclipse.core.variables;
 import org.eclipse.core.runtime.CoreException;
 
 /**
- * A dynamic variable is a variable whose value is computed dynamically
- * by a resolver at the time a string substitution is performed. A dynamic
- * variable is contributed by an extension.
+ * A dynamic variable is a variable whose value is computed dynamically by a
+ * resolver at the time a string substitution is performed. A dynamic variable
+ * is contributed by an extension.
  * <p>
- * The following is a definition of a dynamic variable that resolves to the name of the selected resource:
+ * The following is a definition of a dynamic variable that resolves to the name
+ * of the selected resource:
+ * </p>
+ * 
  * <pre>
  *  &lt;extension point="org.eclipse.core.variables.dynamicVariables"&gt;
  *    &lt;variable
@@ -31,11 +34,11 @@ import org.eclipse.core.runtime.CoreException;
  *    &lt;/variable&gt;
  *  &lt;/extension&gt;
  * </pre>
- * </p>
  * <p>
  * Clients contributing a dynamic variable provide an implementation of
  * {@link org.eclipse.core.variables.IDynamicVariableResolver}.
  * </p>
+ * 
  * @since 3.0
  * @noimplement This interface is not intended to be implemented by clients.
  */
diff --git a/org.eclipse.core.variables/src/org/eclipse/core/variables/IStringVariable.java b/org.eclipse.core.variables/src/org/eclipse/core/variables/IStringVariable.java
index 62e99640b..72d52fdfa 100644
--- a/org.eclipse.core.variables/src/org/eclipse/core/variables/IStringVariable.java
+++ b/org.eclipse.core.variables/src/org/eclipse/core/variables/IStringVariable.java
@@ -15,28 +15,31 @@ package org.eclipse.core.variables;
 
 
 /**
- * A variable that can be referenced in an expression, which resolves to a string
- * value. Variables are referenced in expressions via their name, in the following
- * format.
+ * A variable that can be referenced in an expression, which resolves to a
+ * string value. Variables are referenced in expressions via their name, in the
+ * following format.
+ * 
  * <pre>
  * ${varname} or ${varname:argument}
  * </pre>
  * <p>
- * A variable is identified by its name, and optionally accepts an argument. When an
- * argument is present, a colon separates the variable name from its argument.
+ * A variable is identified by its name, and optionally accepts an argument.
+ * When an argument is present, a colon separates the variable name from its
+ * argument.
  * </p>
  * <p>
  * Variables can be contributed by extensions or programmatically. There are two
  * kinds of variables.
+ * </p>
  * <ul>
- * <li><code>IValueVariable</code> - variables that have a value (with getter and setter), and
- *       accept no arguments. The value of this type of variable is resolved at the time
- *       its value is set via its setter API.</li>
- * <li><code>IDynamicVariable</code> - variables whose value is resolved at the time
- * 		a string substitution is performed by a contributed resolver. Dynamic variables
- * 		may accept an argument.</li>
+ * <li><code>IValueVariable</code> - variables that have a value (with getter
+ * and setter), and accept no arguments. The value of this type of variable is
+ * resolved at the time its value is set via its setter API.</li>
+ * <li><code>IDynamicVariable</code> - variables whose value is resolved at the
+ * time a string substitution is performed by a contributed resolver. Dynamic
+ * variables may accept an argument.</li>
  * </ul>
- * </p>
+ * 
  * @since 3.0
  * @noimplement This interface is not intended to be implemented by clients.
  */
diff --git a/org.eclipse.core.variables/src/org/eclipse/core/variables/IValueVariable.java b/org.eclipse.core.variables/src/org/eclipse/core/variables/IValueVariable.java
index fb9d37262..ef076b1bc 100644
--- a/org.eclipse.core.variables/src/org/eclipse/core/variables/IValueVariable.java
+++ b/org.eclipse.core.variables/src/org/eclipse/core/variables/IValueVariable.java
@@ -14,19 +14,23 @@
 package org.eclipse.core.variables;
 
 /**
- * A variable with a value that can be set and retrieved. The context in which
- * a value variable is referenced does not affect the value of the variable.
- * A value variable can be contributed by an extension or created programmatically.
- * A contributor may optionally specify an initial value for a variable, or
- * provide a delegate that will initialize the variable with a value.
+ * A variable with a value that can be set and retrieved. The context in which a
+ * value variable is referenced does not affect the value of the variable. A
+ * value variable can be contributed by an extension or created
+ * programmatically. A contributor may optionally specify an initial value for a
+ * variable, or provide a delegate that will initialize the variable with a
+ * value.
  * <p>
- * Since 3.3, a variable can be specified as a "read only" preventing users from changing
- * the value after it has been initialized.  Furthermore, a read only variable that is
- * contributed by an extension will always load the value from the extension.
+ * Since 3.3, a variable can be specified as a "read only" preventing users from
+ * changing the value after it has been initialized. Furthermore, a read only
+ * variable that is contributed by an extension will always load the value from
+ * the extension.
  * </p>
  * <p>
  * Example of a value variable contribution with an initial value, the specified
  * variable is created with the initial value "/usr/local/foo".
+ * </p>
+ *
  * <pre>
  *  &lt;extension point="org.eclipse.core.variables.valueVariables"&gt;
  *   &lt;variable
@@ -35,11 +39,12 @@ package org.eclipse.core.variables;
  *   &lt;/variable&gt;
  *  &lt;/extension&gt;
  * </pre>
- * </p>
  * <p>
  * Example of a value variable contribution with an initializer class, the class
  * "com.example.FooLocator" will be used to initialize the value the first time
  * it's requested.
+ * </p>
+ *
  * <pre>
  *  &lt;extension point="org.eclipse.core.variables.valueVariables"&gt;
  *   &lt;variable
@@ -48,7 +53,7 @@ package org.eclipse.core.variables;
  *   &lt;/variable&gt;
  *  &lt;/extension&gt;
  * </pre>
- * </p>
+ *
  * @since 3.0
  * @noimplement This interface is not intended to be implemented by clients.
  */