From 4f047f06fad8882ac81e6770d6ebf022a8331196 Mon Sep 17 00:00:00 2001
From: Henri Sara <henri.sara@gmail.com>
Date: Thu, 16 Feb 2017 11:38:39 +0200
Subject: Fix since tags for 8.0 (#8575)

Fix since tags for the server and shared modules and new types in client.
---
 shared/src/main/java/com/vaadin/shared/AbstractFieldState.java     | 2 +-
 shared/src/main/java/com/vaadin/shared/Range.java                  | 2 +-
 .../java/com/vaadin/shared/data/selection/SelectionServerRpc.java  | 2 ++
 shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java  | 1 +
 shared/src/main/java/com/vaadin/shared/ui/ContentMode.java         | 2 +-
 .../src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java   | 7 +++++++
 shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java          | 2 +-
 shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java     | 2 ++
 shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java      | 2 +-
 .../com/vaadin/shared/ui/datefield/AbstractDateFieldState.java     | 3 ++-
 .../vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java  | 4 ++--
 .../main/java/com/vaadin/shared/ui/datefield/DateResolution.java   | 2 +-
 .../com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java   | 2 +-
 .../java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java   | 4 ++--
 .../com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java    | 4 ++--
 shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java    | 6 ++++++
 shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java  | 2 +-
 shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java   | 2 +-
 .../main/java/com/vaadin/shared/ui/listselect/ListSelectState.java | 2 +-
 .../com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java   | 2 ++
 .../com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java   | 3 ++-
 .../java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java  | 3 ++-
 .../main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java | 6 ++++++
 .../com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java | 3 ++-
 .../com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java | 5 +++++
 .../main/java/com/vaadin/shared/ui/textfield/TextFieldState.java   | 2 ++
 26 files changed, 57 insertions(+), 20 deletions(-)

(limited to 'shared')

diff --git a/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java b/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java
index 4a94a82fec..ddf13b684c 100644
--- a/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/AbstractFieldState.java
@@ -21,7 +21,7 @@ import com.vaadin.shared.ui.TabIndexState;
  * State for components that can show the required indicator.
  *
  * @author Vaadin Ltd
- * @since 8.0.0
+ * @since 8.0
  *
  */
 public class AbstractFieldState extends TabIndexState {
diff --git a/shared/src/main/java/com/vaadin/shared/Range.java b/shared/src/main/java/com/vaadin/shared/Range.java
index 98d9ba54e2..49458d848b 100644
--- a/shared/src/main/java/com/vaadin/shared/Range.java
+++ b/shared/src/main/java/com/vaadin/shared/Range.java
@@ -27,7 +27,7 @@ import java.io.Serializable;
  * The range is considered {@link #isEmpty() empty} if the start is the same as
  * the end.
  *
- * @since 7.4
+ * @since 8.0
  * @author Vaadin Ltd
  */
 public final class Range implements Serializable {
diff --git a/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java b/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java
index 1b79dbea29..19930c7e04 100644
--- a/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/data/selection/SelectionServerRpc.java
@@ -19,6 +19,8 @@ import com.vaadin.shared.communication.ServerRpc;
 
 /**
  * Transmits SelectionModel selection events from the client to the server.
+ * 
+ * @since 8.0
  */
 public interface SelectionServerRpc extends ServerRpc {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java b/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java
index 081abfa8aa..883ade868e 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/ComponentStateUtil.java
@@ -82,6 +82,7 @@ public final class ComponentStateUtil implements Serializable {
      * @param eventListenerId
      *            The event identifier to add
      * @return a registration object for removing the listener
+     * @since 8.0
      */
     public static final Registration addRegisteredEventListener(
             SharedState state, String eventListenerId) {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java b/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java
index e283728425..4c604f4291 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/ContentMode.java
@@ -18,7 +18,7 @@ package com.vaadin.shared.ui;
 /**
  * Content modes defining how the client should interpret a Label's value.
  *
- * @since 7.0
+ * @since 8.0
  */
 public enum ContentMode {
     /**
diff --git a/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java b/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java
index 82431bf7f1..2ffd08ad7d 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/ListingJsonConstants.java
@@ -17,6 +17,13 @@ package com.vaadin.shared.ui;
 
 import java.io.Serializable;
 
+/**
+ * JSON key constants for common listing item attributes in server-client
+ * communication.
+ *
+ * @author Vaadin Ltd
+ * @since 8.0
+ */
 public class ListingJsonConstants implements Serializable {
     public static final String JSONKEY_ITEM_DISABLED = "d";
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java b/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java
index 9e958542d2..327e93bac2 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/MarginInfo.java
@@ -151,7 +151,7 @@ public class MarginInfo implements Serializable {
     /**
      * Checks if this MarginInfo object has no margins enabled.
      *
-     * @since 8.0.0
+     * @since 8.0
      *
      * @return true if all edges have margins disabled
      */
diff --git a/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java b/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java
index 00c7f2c548..52f54aa27b 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/ValueChangeMode.java
@@ -19,6 +19,8 @@ package com.vaadin.shared.ui;
 /**
  * Different modes for when and how often field value changes are transmitted
  * from the client to the server.
+ * 
+ * @since 8.0
  */
 public enum ValueChangeMode {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java b/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java
index 8af9eb12e0..18c735f014 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/WindowOrderRpc.java
@@ -26,7 +26,7 @@ import com.vaadin.shared.communication.ServerRpc;
  * Notifies server when windows order is changed.
  *
  * @author Vaadin Ltd
- * @since 8.0.0
+ * @since 8.0
  *
  */
 public interface WindowOrderRpc extends ServerRpc {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java
index 12a0ebd367..80cd6cbd53 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractDateFieldState.java
@@ -22,8 +22,9 @@ import com.vaadin.shared.annotations.NoLayout;
 
 /**
  * Shared state for the AbstractDateField component.
- * 
+ *
  * @author Vaadin Ltd
+ * @since 8.0
  *
  */
 public class AbstractDateFieldState extends AbstractFieldState {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java
index 843c453f39..2684ab24e2 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/AbstractTextualDateFieldState.java
@@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield;
 
 /**
  * Shared state for the AbstractLocalDateField component.
- * 
- * @author Vaadin Ltd
  *
+ * @author Vaadin Ltd
+ * @since 8.0
  */
 public class AbstractTextualDateFieldState extends AbstractDateFieldState {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java
index ce2871e0a7..70f552673f 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/DateResolution.java
@@ -22,7 +22,7 @@ import java.util.List;
  * Resolutions for DateFields
  *
  * @author Vaadin Ltd.
- * @since 7.0
+ * @since 8.0
  */
 public enum DateResolution {
     DAY, MONTH, YEAR;
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java
index ed64569c7d..c18ab867b1 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/InlineDateTimeFieldState.java
@@ -17,7 +17,7 @@ package com.vaadin.shared.ui.datefield;
 
 /**
  * @author Vaadin Ltd
- *
+ * @since 8.0
  */
 public class InlineDateTimeFieldState extends AbstractTextualDateFieldState {
     {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java
index fdfea3eab6..9cb4fbcf56 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateFieldState.java
@@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield;
 
 /**
  * Shared state for the DateField component.
- * 
- * @author Vaadin Ltd
  *
+ * @author Vaadin Ltd
+ * @since 8.0
  */
 public class LocalDateFieldState extends TextualDateFieldState {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java
index 82cfe8ee6f..eb1c9e8e57 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/datefield/LocalDateTimeFieldState.java
@@ -17,9 +17,9 @@ package com.vaadin.shared.ui.datefield;
 
 /**
  * Shared state for the DateTimeField component.
- * 
- * @author Vaadin Ltd
  *
+ * @author Vaadin Ltd
+ * @since 8.0
  */
 public class LocalDateTimeFieldState extends TextualDateFieldState {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java b/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java
index 05fbb68721..40167ea061 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/grid/ColumnState.java
@@ -17,6 +17,12 @@ package com.vaadin.shared.ui.grid;
 
 import com.vaadin.shared.Connector;
 
+/**
+ * Shared state for a Grid column.
+ *
+ * @author Vaadin Ltd
+ * @since 8.0
+ */
 public class ColumnState extends AbstractGridExtensionState {
 
     public String caption;
diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java
index e1be703b41..644ae9b40f 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/grid/GridServerRpc.java
@@ -79,7 +79,7 @@ public interface GridServerRpc extends ServerRpc {
     /**
      * Informs the server that a column's visibility has been changed.
      *
-     * @since 7.5.0
+     * @since 8.0
      * @param columnInternalId
      *            the internal id of the column
      * @param hidden
diff --git a/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java b/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java
index 7b3e23959f..74eb7bee04 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/grid/SectionState.java
@@ -28,7 +28,7 @@ import com.vaadin.shared.Connector;
  * Shared state for Grid headers and footers.
  *
  * @author Vaadin Ltd
- * @since 7.4
+ * @since 8.0
  */
 public class SectionState implements Serializable {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java b/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java
index add408b868..a749786ae3 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/listselect/ListSelectState.java
@@ -22,7 +22,7 @@ import com.vaadin.shared.ui.abstractmultiselect.AbstractMultiSelectState;
  * Shared state for ListSelect component.
  *
  * @author Vaadin Ltd
- *
+ * @since 8.0
  */
 public class ListSelectState extends AbstractMultiSelectState {
     {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java
index 34c7e750db..8a21fee9c9 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaClientRpc.java
@@ -19,6 +19,8 @@ import com.vaadin.shared.communication.ClientRpc;
 
 /**
  * Server to client RPC interface for RichTextArea.
+ * 
+ * @since 8.0
  */
 public interface RichTextAreaClientRpc extends ClientRpc {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java
index f8d6d9121d..1e3a3f0a2d 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaServerRpc.java
@@ -19,7 +19,8 @@ import com.vaadin.shared.communication.ServerRpc;
 
 /**
  * Client to server RPC interface for RichTextArea.
- *
+ * 
+ * @since 8.0
  */
 public interface RichTextAreaServerRpc extends ServerRpc {
 
diff --git a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java
index 75ce561ec3..d1459d42ce 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/richtextarea/RichTextAreaState.java
@@ -22,7 +22,8 @@ import com.vaadin.shared.ui.ValueChangeMode;
 
 /**
  * State for RichTextArea.
- *
+ * 
+ * @since 8.0
  */
 public class RichTextAreaState extends AbstractFieldState {
     {
diff --git a/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java
index d7a1388ef8..bfcd483e5d 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/textarea/TextAreaServerRpc.java
@@ -17,6 +17,12 @@ package com.vaadin.shared.ui.textarea;
 
 import com.vaadin.shared.communication.ServerRpc;
 
+/**
+ * Client to server RPC interface for TextArea.
+ *
+ * @author Vaadin Ltd
+ * @since 8.0
+ */
 public interface TextAreaServerRpc extends ServerRpc {
 
     public void setHeight(String height);
diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java
index 171707d848..09d19831aa 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldClientRpc.java
@@ -19,7 +19,8 @@ import com.vaadin.shared.communication.ClientRpc;
 
 /**
  * Server to client RPC interface for AbstractTextField.
- *
+ * 
+ * @since 8.0
  */
 public interface AbstractTextFieldClientRpc extends ClientRpc {
     /**
diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java
index e11d4cedec..13279fca32 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/AbstractTextFieldServerRpc.java
@@ -17,6 +17,11 @@ package com.vaadin.shared.ui.textfield;
 
 import com.vaadin.shared.communication.ServerRpc;
 
+/**
+ * Client to server RPC interface for AbstractTextField.
+ *
+ * @since 8.0
+ */
 public interface AbstractTextFieldServerRpc extends ServerRpc {
 
     void setText(String text, int cursorPosition);
diff --git a/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java b/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java
index 02fe1c7f30..8e8b05edce 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/textfield/TextFieldState.java
@@ -17,6 +17,8 @@ package com.vaadin.shared.ui.textfield;
 
 /**
  * State class for TextField.
+ * 
+ * @since 8.0
  */
 public class TextFieldState extends AbstractTextFieldState {
     {
-- 
cgit v1.2.3