Add missing since tags and JavaDocs (#10487)8.3.0.alpha1

4 files changed, 27 insertions, 5 deletions

diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java b/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java
index fbfde9a3f1..21ea8ba4c4 100644
--- a/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java
+++ b/client/src/main/java/com/vaadin/client/ui/VAbstractCalendarPanel.java
@@ -398,7 +398,8 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>>
 
             selectDate(focusedDate);
         } else {
-            getLogger().info("Trying to select a the focused date which is NULL!");
+            getLogger()
+                    .info("Trying to select the focused date which is NULL!");
         }
     }
 
@@ -452,6 +453,14 @@ public abstract class VAbstractCalendarPanel<R extends Enum<R>>
         }
     }
 
+    /**
+     * Sets the style names for dates.
+     *
+     * @param dateStyles
+     *            the map of date string to style name
+     *
+     * @since 8.3
+     */
     public void setDateStyles(Map<String, String> dateStyles) {
         this.dateStyles.clear();
         if (dateStyles != null) {
diff --git a/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java b/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java
index 11102a218e..daa2701e2a 100644
--- a/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java
+++ b/client/src/main/java/com/vaadin/client/ui/VAbstractTextualDate.java
@@ -420,7 +420,7 @@ public abstract class VAbstractTextualDate<R extends Enum<R>>
      *
      * @param textFocus
      *            the focus of the {@link #text}
-     * @since
+     * @since 8.3
      */
     protected void checkGroupFocus(boolean textFocus) {
         boolean newGroupFocus = textFocus | hasChildFocus();
@@ -444,7 +444,7 @@ public abstract class VAbstractTextualDate<R extends Enum<R>>
      *
      * @return {@code true} if any of the child component has focus,
      *         {@code false} otherwise
-     * @since
+     * @since 8.3
      */
     protected boolean hasChildFocus() {
         return false;
diff --git a/client/src/main/java/com/vaadin/client/ui/VRadioButtonGroup.java b/client/src/main/java/com/vaadin/client/ui/VRadioButtonGroup.java
index 3a010c2380..91ea471543 100644
--- a/client/src/main/java/com/vaadin/client/ui/VRadioButtonGroup.java
+++ b/client/src/main/java/com/vaadin/client/ui/VRadioButtonGroup.java
@@ -157,7 +157,8 @@ public class VRadioButtonGroup extends FocusableFlowPanelComposite
         // #9258 apply the v-disabled class when disabled for UX
         button.setStyleName(StyleConstants.DISABLED,
                 !isEnabled() || !optionEnabled);
-        updateItemSelection(button, item.getBoolean(ListingJsonConstants.JSONKEY_ITEM_SELECTED));
+        updateItemSelection(button,
+                item.getBoolean(ListingJsonConstants.JSONKEY_ITEM_SELECTED));
 
         String key = item.getString(DataCommunicatorConstants.KEY);
 
@@ -260,7 +261,8 @@ public class VRadioButtonGroup extends FocusableFlowPanelComposite
     public void selectItemKey(String selectedItemKey) {
         // At most one item could be selected so reset all radio buttons
         // before applying current selection
-        keyToOptions.values().forEach(button -> updateItemSelection(button, false));
+        keyToOptions.values()
+                .forEach(button -> updateItemSelection(button, false));
         if (selectedItemKey != null) {
             RadioButton radioButton = keyToOptions.get(selectedItemKey);
             if (radioButton != null) { // Items might not be loaded yet
@@ -269,6 +271,14 @@ public class VRadioButtonGroup extends FocusableFlowPanelComposite
         }
     }
 
+    /**
+     * Updates the selected state of a radio button.
+     * 
+     * @param radioButton
+     *            the radio button to update
+     * @param value
+     *            {@code true} if selected; {@code false} if not
+     */
     protected void updateItemSelection(RadioButton radioButton, boolean value) {
         radioButton.setValue(value);
         radioButton.setStyleName(CLASSNAME_OPTION_SELECTED, value);
diff --git a/client/src/main/java/com/vaadin/client/widgets/Grid.java b/client/src/main/java/com/vaadin/client/widgets/Grid.java
index 405b6ab208..9e186ba64d 100755
--- a/client/src/main/java/com/vaadin/client/widgets/Grid.java
+++ b/client/src/main/java/com/vaadin/client/widgets/Grid.java
@@ -5548,6 +5548,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>,
          * 
          * @return {@code true} to handle events from widgets; {@code false} to
          *         not
+         * @since 8.3
          */
         public boolean isWidgetEventsAllowed() {
             return widgetEventsAllowed;
@@ -5559,6 +5560,8 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>,
          * @param widgetEventsAllowed
          *            {@code true} to let grid handle events from widgets;
          *            {@code false} to not
+         *
+         * @since 8.3
          */
         public void setWidgetEventsAllowed(boolean widgetEventsAllowed) {
             this.widgetEventsAllowed = widgetEventsAllowed;