Update/add @since tags in javadoc

Change-Id: Ifd93251fdc20b93ad276c551796557bb9026766a

13 files changed, 30 insertions, 16 deletions

diff --git a/server/src/com/vaadin/event/ContextClickEvent.java b/server/src/com/vaadin/event/ContextClickEvent.java
index 88b46d938b..5b15634105 100644
--- a/server/src/com/vaadin/event/ContextClickEvent.java
+++ b/server/src/com/vaadin/event/ContextClickEvent.java
@@ -27,7 +27,7 @@ import com.vaadin.util.ReflectTools;
  * Context click event fired by a {@link Component}. ContextClickEvent happens
  * when context click happens on the client-side inside the Component.
  * 
- * @since
+ * @since 7.6
  * @author Vaadin Ltd
  */
 public class ContextClickEvent extends ClickEvent {
diff --git a/server/src/com/vaadin/server/VaadinSession.java b/server/src/com/vaadin/server/VaadinSession.java
index dac4f40f5a..f5e400bb3a 100644
--- a/server/src/com/vaadin/server/VaadinSession.java
+++ b/server/src/com/vaadin/server/VaadinSession.java
@@ -781,7 +781,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable {
      * Checks if the current thread has exclusive access to this VaadinSession
      *
      * @return true if the thread has exclusive access, false otherwise
-     * @since
+     * @since 7.1
      */
     public boolean hasLock() {
         ReentrantLock l = ((ReentrantLock) getLockInstance());
@@ -793,7 +793,7 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable {
      * WrappedSession.
      *
      * @return true if this thread has exclusive access, false otherwise
-     * @since
+     * @since 7.6
      */
     protected static boolean hasLock(VaadinService service,
             WrappedSession session) {
diff --git a/server/src/com/vaadin/server/WebBrowser.java b/server/src/com/vaadin/server/WebBrowser.java
index 1205fece74..5b7d795793 100644
--- a/server/src/com/vaadin/server/WebBrowser.java
+++ b/server/src/com/vaadin/server/WebBrowser.java
@@ -128,6 +128,7 @@ public class WebBrowser implements Serializable {
     /**
      * Tests whether the user is using Edge.
      * 
+     * @since 7.5.3
      * @return true if the user is using Edge, false if the user is not using
      *         Edge or if no information on the browser is present
      */
diff --git a/server/src/com/vaadin/server/WrappedPortletSession.java b/server/src/com/vaadin/server/WrappedPortletSession.java
index a8eff75983..7960003358 100644
--- a/server/src/com/vaadin/server/WrappedPortletSession.java
+++ b/server/src/com/vaadin/server/WrappedPortletSession.java
@@ -73,7 +73,7 @@ public class WrappedPortletSession implements WrappedSession {
      * @see PortletSession#PORTLET_SCOPE
      * @see PortletSession#APPLICATION_SCOPE
      * 
-     * @since
+     * @since 7.6
      */
     public Object getAttribute(String name, int scope) {
         return session.getAttribute(name, scope);
@@ -113,7 +113,7 @@ public class WrappedPortletSession implements WrappedSession {
      * @see PortletSession#PORTLET_SCOPE
      * @see PortletSession#APPLICATION_SCOPE
      * 
-     * @since
+     * @since 7.6
      */
     public void setAttribute(String name, Object value, int scope) {
         session.setAttribute(name, value, scope);
@@ -144,7 +144,7 @@ public class WrappedPortletSession implements WrappedSession {
      * 
      * @see PortletSession#getAttributeNames()
      * 
-     * @since
+     * @since 7.6
      */
     public Set<String> getAttributeNames(int scope) {
         return WrappedHttpSession.enumerationToSet(session
@@ -200,7 +200,7 @@ public class WrappedPortletSession implements WrappedSession {
      * @see PortletSession#PORTLET_SCOPE
      * @see PortletSession#APPLICATION_SCOPE
      * 
-     * @since
+     * @since 7.6
      */
     public void removeAttribute(String name, int scope) {
         session.removeAttribute(name, scope);
diff --git a/server/src/com/vaadin/server/communication/PushHandler.java b/server/src/com/vaadin/server/communication/PushHandler.java
index b2fc096a85..483c0abc44 100644
--- a/server/src/com/vaadin/server/communication/PushHandler.java
+++ b/server/src/com/vaadin/server/communication/PushHandler.java
@@ -517,6 +517,7 @@ public class PushHandler {
      * timeout to a value smaller than the proxy timeout so that the server is
      * aware of a reconnect taking place.
      * 
+     * @since 7.6
      * @param suspendTimeout
      *            the timeout to use for suspended AtmosphereResources
      */
@@ -527,6 +528,7 @@ public class PushHandler {
     /**
      * Gets the timeout used for suspend calls when using long polling.
      * 
+     * @since 7.6
      * @return the timeout to use for suspended AtmosphereResources
      */
     public int getLongPollingSuspendTimeout() {
diff --git a/server/src/com/vaadin/server/communication/ServerRpcHandler.java b/server/src/com/vaadin/server/communication/ServerRpcHandler.java
index f3d4b163ff..593b1f544f 100644
--- a/server/src/com/vaadin/server/communication/ServerRpcHandler.java
+++ b/server/src/com/vaadin/server/communication/ServerRpcHandler.java
@@ -167,6 +167,7 @@ public class ServerRpcHandler implements Serializable {
         /**
          * Gets the id of the client to server message
          * 
+         * @since 7.6
          * @return the server message id
          */
         public int getClientToServerId() {
diff --git a/server/src/com/vaadin/ui/AbstractField.java b/server/src/com/vaadin/ui/AbstractField.java
index 61f58157ea..e69322b1cc 100644
--- a/server/src/com/vaadin/ui/AbstractField.java
+++ b/server/src/com/vaadin/ui/AbstractField.java
@@ -471,7 +471,7 @@ public abstract class AbstractField<T> extends AbstractComponent implements
     /**
      * Sets the value of the field.
      * 
-     * @since
+     * @since 7.5.7
      * @param newFieldValue
      *            the New value of the field.
      * @param repaintIsNotNeeded
diff --git a/server/src/com/vaadin/ui/AbstractSelect.java b/server/src/com/vaadin/ui/AbstractSelect.java
index 8fab8ec3a0..69eed32afb 100644
--- a/server/src/com/vaadin/ui/AbstractSelect.java
+++ b/server/src/com/vaadin/ui/AbstractSelect.java
@@ -699,6 +699,7 @@ public abstract class AbstractSelect extends AbstractField<Object> implements
      * multiselect mode all collections of id:s can be assigned.
      * </p>
      * 
+     * @since 7.5.7
      * @param newValue
      *            the New selected item or collection of selected items.
      * @param repaintIsNotNeeded
diff --git a/server/src/com/vaadin/ui/Grid.java b/server/src/com/vaadin/ui/Grid.java
index 06a3c16fd7..3907156265 100644
--- a/server/src/com/vaadin/ui/Grid.java
+++ b/server/src/com/vaadin/ui/Grid.java
@@ -390,7 +390,7 @@ public class Grid extends AbstractFocusable implements SelectionNotifier,
     /**
      * ContextClickEvent for the Grid Component.
      * 
-     * @since
+     * @since 7.6
      */
     public static class GridContextClickEvent extends ContextClickEvent {
 
@@ -1801,6 +1801,7 @@ public class Grid extends AbstractFocusable implements SelectionNotifier,
     /**
      * Abstract base class for Grid header and footer sections.
      * 
+     * @since 7.6
      * @param <ROWTYPE>
      *            the type of the rows in the section
      */
@@ -3721,6 +3722,7 @@ public class Grid extends AbstractFocusable implements SelectionNotifier,
          * given converter and renderer. This method is public only for testing
          * purposes.
          * 
+         * @since 7.6
          * @param renderer
          *            the renderer to use
          * @param converter
diff --git a/server/src/com/vaadin/ui/PushConfiguration.java b/server/src/com/vaadin/ui/PushConfiguration.java
index ef9fc0556e..6ef323cea8 100644
--- a/server/src/com/vaadin/ui/PushConfiguration.java
+++ b/server/src/com/vaadin/ui/PushConfiguration.java
@@ -145,7 +145,7 @@ public interface PushConfiguration extends Serializable {
      * This is only used when overriding the URL to use. Setting this to null
      * (the default) will use the default URL.
      * 
-     * @since
+     * @since 7.6
      * @param pushUrl
      *            The push URL to use
      */
@@ -157,7 +157,7 @@ public interface PushConfiguration extends Serializable {
      * This is only used when overriding the URL to use. Returns null (the
      * default) when the default URL is used.
      * 
-     * @since
+     * @since 7.6
      * @return the URL to use for push requests, or null to use to default
      */
     public String getPushUrl();
diff --git a/server/src/com/vaadin/ui/Table.java b/server/src/com/vaadin/ui/Table.java
index 62aca78223..7f2a8e96e2 100644
--- a/server/src/com/vaadin/ui/Table.java
+++ b/server/src/com/vaadin/ui/Table.java
@@ -5776,7 +5776,9 @@ public class Table extends AbstractSelect implements Action.Container,
     }
 
     /**
-     * This event is fired when the collapse state of a column changes
+     * This event is fired when the collapse state of a column changes.
+     * 
+     * @since 7.6
      */
     public static class ColumnCollapseEvent extends Component.Event {
 
@@ -5810,6 +5812,8 @@ public class Table extends AbstractSelect implements Action.Container,
 
     /**
      * Interface for listening to column collapse events.
+     * 
+     * @since 7.6
      */
     public interface ColumnCollapseListener extends Serializable {
 
@@ -5867,6 +5871,8 @@ public class Table extends AbstractSelect implements Action.Container,
      * Adds a column collapse listener to the Table. A column collapse listener
      * is called when the collapsed state of a column changes.
      * 
+     * @since 7.6
+     * 
      * @param listener
      *            The listener to attach
      */
@@ -5877,7 +5883,8 @@ public class Table extends AbstractSelect implements Action.Container,
 
     /**
      * Removes a column reorder listener from the Table.
-     * 
+     *
+     * @since 7.6
      * @param listener
      *            The listener to remove
      */
diff --git a/server/src/com/vaadin/ui/Tree.java b/server/src/com/vaadin/ui/Tree.java
index 2c537e3a98..b0f41b382e 100644
--- a/server/src/com/vaadin/ui/Tree.java
+++ b/server/src/com/vaadin/ui/Tree.java
@@ -1946,7 +1946,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical,
      * <code>false</code>, the content is passed to the browser as plain text.
      * The default setting is <code>false</code>
      * 
-     * @since
+     * @since 7.6
      * @param htmlContentAllowed
      *            <code>true</code> if the captions are used as html,
      *            <code>false</code> if used as plain text
@@ -1959,7 +1959,7 @@ public class Tree extends AbstractSelect implements Container.Hierarchical,
     /**
      * Checks whether captions are interpreted as html or plain text.
      * 
-     * @since
+     * @since 7.6
      * @return <code>true</code> if the captions are displayed as html,
      *         <code>false</code> if displayed as plain text
      * @see #setHtmlContentAllowed(boolean)
diff --git a/server/src/com/vaadin/ui/declarative/DesignFormatter.java b/server/src/com/vaadin/ui/declarative/DesignFormatter.java
index 3ab0b9c12f..dbeb756dd8 100644
--- a/server/src/com/vaadin/ui/declarative/DesignFormatter.java
+++ b/server/src/com/vaadin/ui/declarative/DesignFormatter.java
@@ -403,7 +403,7 @@ public class DesignFormatter implements Serializable {
      * unencodes more characters than {@link #encodeForTextNode(String)} encodes
      * </p>
      * 
-     * @since
+     * @since 7.6
      * @param input
      * @return
      */