From 580d60744473b2d01547b1daa4049603c7f05561 Mon Sep 17 00:00:00 2001
From: Teemu Suo-Anttila <tsuoanttila@users.noreply.github.com>
Date: Wed, 3 Jan 2018 13:32:56 +0200
Subject: Add missing since tags and JavaDocs (#10487)

---
 server/src/main/java/com/vaadin/data/PropertyDefinition.java | 9 ++++++---
 server/src/main/java/com/vaadin/ui/AbstractDateField.java    | 4 ++++
 server/src/main/java/com/vaadin/ui/Grid.java                 | 2 ++
 server/src/main/java/com/vaadin/ui/MenuBar.java              | 4 ++--
 4 files changed, 14 insertions(+), 5 deletions(-)

(limited to 'server')

diff --git a/server/src/main/java/com/vaadin/data/PropertyDefinition.java b/server/src/main/java/com/vaadin/data/PropertyDefinition.java
index 68be55a48b..a4b90d024a 100644
--- a/server/src/main/java/com/vaadin/data/PropertyDefinition.java
+++ b/server/src/main/java/com/vaadin/data/PropertyDefinition.java
@@ -71,12 +71,15 @@ public interface PropertyDefinition<T, V> extends Serializable {
     public String getName();
 
     /**
-     * Gets the top level name of this property
+     * Gets the top level name of this property.
      * 
      * @return the top level property name, not <code>null</code>
+     * @since 8.3
      */
-    public default String getTopLevelName() {return getName();}
-    
+    public default String getTopLevelName() {
+        return getName();
+    }
+
     /**
      * Gets the human readable caption to show for this property.
      *
diff --git a/server/src/main/java/com/vaadin/ui/AbstractDateField.java b/server/src/main/java/com/vaadin/ui/AbstractDateField.java
index 781848cb19..1198e04d66 100644
--- a/server/src/main/java/com/vaadin/ui/AbstractDateField.java
+++ b/server/src/main/java/com/vaadin/ui/AbstractDateField.java
@@ -826,6 +826,8 @@ public abstract class AbstractDateField<T extends Temporal & TemporalAdjuster &
      * @param styleName
      *            the custom style name(s) for given date, {@code null} to clear
      *            custom style name(s)
+     *
+     * @since 8.3
      */
     public void setDateStyle(LocalDate date, String styleName) {
         if (date != null) {
@@ -846,6 +848,7 @@ public abstract class AbstractDateField<T extends Temporal & TemporalAdjuster &
      * @return the corresponding style name(s), if any, {@code null} otherwise
      *
      * @see {@link #setDateStyle(LocalDate, String)}
+     * @since 8.3
      */
     public String getDateStyle(LocalDate date) {
         if (date == null) {
@@ -861,6 +864,7 @@ public abstract class AbstractDateField<T extends Temporal & TemporalAdjuster &
      * @return map from dates to custom style names in each date's calendar cell
      *
      * @see {@link #setDateStyle(LocalDate, String)}
+     * @since 8.3
      */
     public Map<LocalDate, String> getDateStyles() {
         HashMap<LocalDate, String> hashMap = new HashMap<>();
diff --git a/server/src/main/java/com/vaadin/ui/Grid.java b/server/src/main/java/com/vaadin/ui/Grid.java
index 58945bfc46..803ac58b58 100644
--- a/server/src/main/java/com/vaadin/ui/Grid.java
+++ b/server/src/main/java/com/vaadin/ui/Grid.java
@@ -2068,6 +2068,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents,
          * @param widgetEventsAllowed
          *            {@code true} to handle events; {@code false} to not
          * @return this column
+         * @since 8.3
          */
         public Column<T, V> setWidgetEventsAllowed(
                 boolean widgetEventsAllowed) {
@@ -2084,6 +2085,7 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents,
          * @see #setWidgetEventsAllowed(boolean)
          * 
          * @return {@code true} if handling events; {@code false} if not
+         * @since 8.3
          */
         public boolean isWidgetEventsAllowed() {
             return getState(false).widgetEventsAllowed;
diff --git a/server/src/main/java/com/vaadin/ui/MenuBar.java b/server/src/main/java/com/vaadin/ui/MenuBar.java
index 72a3671d4e..1525782c8a 100644
--- a/server/src/main/java/com/vaadin/ui/MenuBar.java
+++ b/server/src/main/java/com/vaadin/ui/MenuBar.java
@@ -821,7 +821,7 @@ public class MenuBar extends AbstractComponent
          *            the new description string for the component.
          * @param mode
          *            the content mode for the description
-         * @since
+         * @since 8.3
          */
         public void setDescription(String description, ContentMode mode) {
             this.description = description;
@@ -900,7 +900,7 @@ public class MenuBar extends AbstractComponent
          *
          * @return the {@link ContentMode} of the description of this menu item
          * @see ContentMode
-         * @since
+         * @since 8.3
          */
         public ContentMode getContentMode() {
             return contentMode;
-- 
cgit v1.2.3