SONAR-6567 clean-up some useless javadoc

diff --git a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationCenter.java b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationCenter.java
index b739a60edcd4a5f09f3fdf5b3544ff3f2c76bbfe..c5ad52e16982339f60479cd556eeadd38283fbc7 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationCenter.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationCenter.java
@@ -20,20 +20,13 @@
 package org.sonar.server.notification;
 
 import com.google.common.collect.Lists;
-import org.sonar.api.server.ServerSide;
+import java.util.Arrays;
+import java.util.List;
+import javax.annotation.Nullable;
 import org.sonar.api.notifications.NotificationChannel;
 import org.sonar.api.utils.log.Logger;
 import org.sonar.api.utils.log.Loggers;
 
-import javax.annotation.Nullable;
-
-import java.util.Arrays;
-import java.util.List;
-
-/**
- * @since 3.5
- */
-@ServerSide
 public class NotificationCenter {
 
   private static final Logger LOG = Loggers.get(NotificationCenter.class);
@@ -41,9 +34,6 @@ public class NotificationCenter {
   private final NotificationDispatcherMetadata[] dispatchersMetadata;
   private final NotificationChannel[] channels;
 
-  /**
-   * Constructor for {@link NotificationCenter}
-   */
   public NotificationCenter(NotificationDispatcherMetadata[] metadata, NotificationChannel[] channels) {
     this.dispatchersMetadata = metadata;
     this.channels = channels;
@@ -64,17 +54,11 @@ public class NotificationCenter {
     this(new NotificationDispatcherMetadata[0], channels);
   }
 
-  /**
-   * Default constructor.
-   */
   public NotificationCenter() {
     this(new NotificationDispatcherMetadata[0], new NotificationChannel[0]);
     LOG.warn("There is no notification channel - no notification will be delivered!");
   }
 
-  /**
-   * Returns all the available channels.
-   */
   public List<NotificationChannel> getChannels() {
     return Arrays.asList(channels);
   }

diff --git a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcher.java b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcher.java
index 3c99cbe0003183c9f30afa774cb607fe2896c3d0..f0d81e8b05bfbb131ecc692a9e1fc24ff4507a13 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcher.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcher.java
@@ -37,9 +37,7 @@ import org.sonar.api.server.ServerSide;
  * <li>notify me by Jabber when someone mentions me in an issue comment</li>
  * <li>send me by SMS when there are system notifications (like password reset, account creation, ...)</li>
  * </ul> 
- * 
- * @since 2.10
- */
+  */
 @ServerSide
 @ExtensionPoint
 public abstract class NotificationDispatcher {

diff --git a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcherMetadata.java b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcherMetadata.java
index de80ec7a2a7691216175be38276b26fe91a7b0cc..cece1ad0073891fc26c95fc99a7549e84ede8baa 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcherMetadata.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationDispatcherMetadata.java
@@ -29,8 +29,6 @@ import org.sonar.api.server.ServerSide;
  * to tell more about them.
  * <p/>
  * Instances of these classes must be declared in {@link org.sonar.api.SonarPlugin#getExtensions()}.
- *
- * @since 3.5
  */
 @ServerSide
 public final class NotificationDispatcherMetadata {

diff --git a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationManager.java b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationManager.java
index d499a8fcc5ceab95bf8a8c61bab7e01415156406..0b14c47f0902cdfb5f0e5ecc502b82493455a02d 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationManager.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationManager.java
@@ -26,9 +26,7 @@ import org.sonar.api.notifications.Notification;
 import org.sonar.api.notifications.NotificationChannel;
 
 /**
- * <p>
  * The notification manager receives notifications and is in charge of storing them so that they are processed by the notification service.
- * </p>
  * <p>
  * Pico provides an instance of this class, and plugins just need to create notifications and pass them to this manager with
  * the {@link NotificationManager#scheduleForSending(Notification)} method.

diff --git a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationService.java b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationService.java
index b3951e8ee0285f927731adac413fdbae6bbc31b5..8ab6ab4c6261b2f1bf69a8e98c150f1649fec05e 100644 (file)
--- a/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationService.java
+++ b/server/sonar-server/src/main/java/org/sonar/server/notification/NotificationService.java
@@ -34,18 +34,15 @@ import java.util.concurrent.TimeUnit;
 import org.picocontainer.Startable;
 import org.sonar.api.Properties;
 import org.sonar.api.Property;
-import org.sonar.api.server.ServerSide;
 import org.sonar.api.config.Settings;
 import org.sonar.api.notifications.Notification;
 import org.sonar.api.notifications.NotificationChannel;
+import org.sonar.api.server.ServerSide;
 import org.sonar.api.utils.log.Logger;
 import org.sonar.api.utils.log.Loggers;
 import org.sonar.jpa.session.DatabaseSessionFactory;
 import org.sonar.server.db.DbClient;
 
-/**
- * @since 2.10
- */
 @Properties({
   @Property(
     key = NotificationService.PROPERTY_DELAY,
@@ -78,11 +75,8 @@ public class NotificationService implements Startable {
   private ScheduledExecutorService executorService;
   private boolean stopping = false;
 
-  /**
-   * Constructor for {@link NotificationService}
-   */
   public NotificationService(Settings settings, DefaultNotificationManager manager, DbClient dbClient,
-                             DatabaseSessionFactory databaseSessionFactory, NotificationDispatcher[] dispatchers) {
+    DatabaseSessionFactory databaseSessionFactory, NotificationDispatcher[] dispatchers) {
     this.databaseSessionFactory = databaseSessionFactory;
     this.delayInSeconds = settings.getLong(PROPERTY_DELAY);
     this.delayBeforeReportingStatusInSeconds = settings.getLong(PROPERTY_DELAY_BEFORE_REPORTING_STATUS);
@@ -95,7 +89,7 @@ public class NotificationService implements Startable {
    * Default constructor when no dispatchers.
    */
   public NotificationService(Settings settings, DefaultNotificationManager manager, DbClient dbClient,
-                             DatabaseSessionFactory databaseSessionFactory) {
+    DatabaseSessionFactory databaseSessionFactory) {
     this(settings, manager, dbClient, databaseSessionFactory, new NotificationDispatcher[0]);
   }