Bug 545330 - Problems in javadoc for platformI20190325-0105I20190324-1800I20190323-1800I20190322-1800I20190321-1800I20190321-0435I20190321-0245I20190320-1800I20190318-1800

Fix javadoc warnings in equinox.bundles.

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

8 files changed, 15 insertions, 11 deletions

diff --git a/bundles/org.eclipse.equinox.preferences/META-INF/MANIFEST.MF b/bundles/org.eclipse.equinox.preferences/META-INF/MANIFEST.MF
index 96d840a56..a04bfb507 100644
--- a/bundles/org.eclipse.equinox.preferences/META-INF/MANIFEST.MF
+++ b/bundles/org.eclipse.equinox.preferences/META-INF/MANIFEST.MF
@@ -2,7 +2,7 @@ Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: %pluginName
 Bundle-SymbolicName: org.eclipse.equinox.preferences; singleton:=true
-Bundle-Version: 3.7.300.qualifier
+Bundle-Version: 3.7.400.qualifier
 Bundle-Activator: org.eclipse.core.internal.preferences.Activator
 Bundle-Vendor: %providerName
 Bundle-Localization: plugin
diff --git a/bundles/org.eclipse.equinox.preferences/pom.xml b/bundles/org.eclipse.equinox.preferences/pom.xml
index 185cf313d..02af95682 100644
--- a/bundles/org.eclipse.equinox.preferences/pom.xml
+++ b/bundles/org.eclipse.equinox.preferences/pom.xml
@@ -19,6 +19,6 @@
   </parent>
   <groupId>org.eclipse.equinox</groupId>
   <artifactId>org.eclipse.equinox.preferences</artifactId>
-  <version>3.7.300-SNAPSHOT</version>
+  <version>3.7.400-SNAPSHOT</version>
   <packaging>eclipse-plugin</packaging>
 </project>
diff --git a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IEclipsePreferences.java b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IEclipsePreferences.java
index 1cd641861..a3a3fe427 100644
--- a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IEclipsePreferences.java
+++ b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IEclipsePreferences.java
@@ -315,7 +315,9 @@ public interface IEclipsePreferences extends Preferences {
 	 *
 	 * @param visitor the visitor
 	 * @see IPreferenceNodeVisitor#visit(IEclipsePreferences)
-	 * @throws BackingStoreException
+	 * @throws BackingStoreException if this operation cannot be completed due
+	 *         to a failure in the backing store, or inability to communicate
+	 *         with it.
 	 */
 	public void accept(IPreferenceNodeVisitor visitor) throws BackingStoreException;
 }
diff --git a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferenceNodeVisitor.java b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferenceNodeVisitor.java
index 0326eb760..0dbaabb63 100644
--- a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferenceNodeVisitor.java
+++ b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferenceNodeVisitor.java
@@ -45,7 +45,9 @@ public interface IPreferenceNodeVisitor {
 	 * @param node the node to visit
 	 * @return <code>true</code> if the node's children should
 	 *		be visited; <code>false</code> if they should be skipped
-	 * @throws BackingStoreException
+	 * @throws BackingStoreException if this operation cannot be completed due
+	 *         to a failure in the backing store, or inability to communicate
+	 *         with it.
 	 */
 	public boolean visit(IEclipsePreferences node) throws BackingStoreException;
 }
diff --git a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferencesService.java b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferencesService.java
index 23f4539a8..c2311e4c0 100644
--- a/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferencesService.java
+++ b/bundles/org.eclipse.equinox.preferences/src/org/eclipse/core/runtime/preferences/IPreferencesService.java
@@ -611,7 +611,7 @@ public interface IPreferencesService {
 	 * @param node the tree to export
 	 * @param filters the list of filters to export
 	 * @param output the stream to export to
-	 * @throws CoreException
+	 * @throws CoreException if there was a problem exporting the preferences
 	 * @see #exportPreferences(IEclipsePreferences, OutputStream, String[])
 	 * @see #readPreferences(InputStream)
 	 * @see #applyPreferences(IEclipsePreferences, IPreferenceFilter[])
@@ -629,7 +629,7 @@ public interface IPreferencesService {
 	 * @param node the tree to match against
 	 * @param filters the list of filters to match against
 	 * @return the array of matching transfers
-	 * @throws CoreException
+	 * @throws CoreException if there are problems during matching
 	 * @see IPreferenceFilter
 	 * @since 3.1
 	 */
@@ -650,7 +650,7 @@ public interface IPreferencesService {
 	 *
 	 * @param node the tree to consider applying
 	 * @param filters the filters to use
-	 * @throws CoreException
+	 * @throws CoreException if there are problems applying the preferences
 	 * @see #applyPreferences(IExportedPreferences)
 	 * @see #readPreferences(InputStream)
 	 * @see IPreferenceFilter
diff --git a/bundles/org.eclipse.equinox.security/META-INF/MANIFEST.MF b/bundles/org.eclipse.equinox.security/META-INF/MANIFEST.MF
index 4ca6438c1..6c57f9ea7 100644
--- a/bundles/org.eclipse.equinox.security/META-INF/MANIFEST.MF
+++ b/bundles/org.eclipse.equinox.security/META-INF/MANIFEST.MF
@@ -2,7 +2,7 @@ Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: %pluginName
 Bundle-SymbolicName: org.eclipse.equinox.security;singleton:=true
-Bundle-Version: 1.3.100.qualifier
+Bundle-Version: 1.3.200.qualifier
 Bundle-Vendor: %providerName
 Bundle-Localization: plugin
 Bundle-Activator: org.eclipse.equinox.internal.security.auth.AuthPlugin
diff --git a/bundles/org.eclipse.equinox.security/pom.xml b/bundles/org.eclipse.equinox.security/pom.xml
index fae53ad67..b1b4acf2d 100644
--- a/bundles/org.eclipse.equinox.security/pom.xml
+++ b/bundles/org.eclipse.equinox.security/pom.xml
@@ -19,7 +19,7 @@
   </parent>
   <groupId>org.eclipse.equinox</groupId>
   <artifactId>org.eclipse.equinox.security</artifactId>
-  <version>1.3.100-SNAPSHOT</version>
+  <version>1.3.200-SNAPSHOT</version>
   <packaging>eclipse-plugin</packaging>
 
   <build>
diff --git a/bundles/org.eclipse.equinox.security/src/org/eclipse/equinox/security/auth/ILoginContext.java b/bundles/org.eclipse.equinox.security/src/org/eclipse/equinox/security/auth/ILoginContext.java
index b245f6851..d7298566d 100644
--- a/bundles/org.eclipse.equinox.security/src/org/eclipse/equinox/security/auth/ILoginContext.java
+++ b/bundles/org.eclipse.equinox.security/src/org/eclipse/equinox/security/auth/ILoginContext.java
@@ -31,14 +31,14 @@ public interface ILoginContext {
 	/**
 	 * Call this method to perform a login. 
 	 * @see LoginContext#login()
-	 * @throws LoginException
+	 * @throws LoginException if the authentication fails.
 	 */
 	public void login() throws LoginException;
 
 	/**
 	 * Call this method to perform a logout.
 	 * @see LoginContext#logout()
-	 * @throws LoginException
+	 * @throws LoginException if the logout fails.
 	 */
 	public void logout() throws LoginException;