added missing javadocs and since tags (#10315)7.7.12

* added missing javadocs and since tags

* fix formatting of javadocs

5 files changed, 27 insertions, 8 deletions

diff --git a/client/src/main/java/com/vaadin/client/VErrorMessage.java b/client/src/main/java/com/vaadin/client/VErrorMessage.java
index e13bca9c6a..4b86038c1f 100644
--- a/client/src/main/java/com/vaadin/client/VErrorMessage.java
+++ b/client/src/main/java/com/vaadin/client/VErrorMessage.java
@@ -65,7 +65,7 @@ public class VErrorMessage extends FlowPanel {
      *
      * @param errorLevel
      *         error level
-     * @since
+     * @since 7.7.11
      */
     public void updateErrorLevel(ErrorLevel errorLevel) {
         ErrorUtil.setErrorLevelStyle(getStyleElement(), CLASSNAME, errorLevel);
diff --git a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java
index 7b55fa958c..7fa7e8708f 100644
--- a/client/src/main/java/com/vaadin/client/ui/FocusUtil.java
+++ b/client/src/main/java/com/vaadin/client/ui/FocusUtil.java
@@ -97,22 +97,42 @@ public class FocusUtil {
         return focusable.getElement().getTabIndex();
     }
 
+    /**
+     * Get all the child elements of a parent that are focusable.
+     * 
+     * @param parent
+     *            The parent element whose children to search.
+     * @return Array of child Elements that are focusable.
+     * @since 7.7.12
+     */
     public static native Element[] getFocusableChildren(Element parent)
     /*-{
         var focusableChildren = parent.querySelectorAll('[type][tabindex]:not([tabindex="-1"]), [role=button][tabindex]:not([tabindex="-1"])');
         return focusableChildren;
     }-*/;
 
-    public static void focusOnFirstFocusableElement(Element parent)
-    {
+    /**
+     * Focus on the first focusable child Element of a parent Element.
+     * 
+     * @param parent
+     *            The parent element to scan for a focusable child.
+     * @since 7.7.12
+     */
+    public static void focusOnFirstFocusableElement(Element parent) {
         Element[] focusableChildren = getFocusableChildren(parent);
         if (focusableChildren.length > 0) {
             focusableChildren[0].focus();
         }
     }
 
-    public static void focusOnLastFocusableElement(Element parent)
-    {
+    /**
+     * Focus on the last focusable child Element of a parent Element.
+     * 
+     * @param parent
+     *            The parent element to scan for a focusable child.
+     * @since 7.7.12
+     */
+    public static void focusOnLastFocusableElement(Element parent) {
         Element[] focusableChildren = getFocusableChildren(parent);
         if (focusableChildren.length > 0) {
             focusableChildren[focusableChildren.length - 1].focus();
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 daf6974ada..857f95002f 100755
--- a/client/src/main/java/com/vaadin/client/widgets/Grid.java
+++ b/client/src/main/java/com/vaadin/client/widgets/Grid.java
@@ -9120,7 +9120,7 @@ public class Grid<T> extends ResizeComposite implements HasSelectionHandlers<T>,
     /**
      * Update details row height.
      *
-     * @since
+     * @since 7.7.11
      * @param rowIndex
      *            the index of the row for which to update details height
      * @param height
diff --git a/server/src/main/java/com/vaadin/ui/ConnectorTracker.java b/server/src/main/java/com/vaadin/ui/ConnectorTracker.java
index d2b9b65764..5b0f0bfad8 100644
--- a/server/src/main/java/com/vaadin/ui/ConnectorTracker.java
+++ b/server/src/main/java/com/vaadin/ui/ConnectorTracker.java
@@ -443,7 +443,6 @@ public class ConnectorTracker implements Serializable {
      *
      * @return <code>true</code> if the hierarchy is consistent,
      *         <code>false</code> otherwise
-     * @since
      */
     private boolean isHierarchyComplete() {
         boolean noErrors = true;
diff --git a/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java b/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java
index 2993bef43f..dc3efb8a9b 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/ErrorLevel.java
@@ -18,7 +18,7 @@ package com.vaadin.shared.ui;
 /**
  * Represents the error levels displayed on components.
  * @author Vaadin Ltd
- * @since
+ * @since 7.7.11
  */
 public enum ErrorLevel {