Minor javadoc improvements (#9885)

diff --git a/server/src/main/java/com/vaadin/data/Binder.java b/server/src/main/java/com/vaadin/data/Binder.java
index 43f893e33f1c0bd74eafe7945ea4ff61209256de..7632f2b09b144a584ca77d7eb98ff9e996ac0d72 100644 (file)
--- a/server/src/main/java/com/vaadin/data/Binder.java
+++ b/server/src/main/java/com/vaadin/data/Binder.java
@@ -487,14 +487,13 @@ public class Binder<BEAN> implements Serializable {
         /**
          * Sets the field to be required. This means two things:
          * <ol>
-         * <li>the required indicator is visible</li>
-         * <li>the field value is validated for not being empty*</li>
+         * <li>the field value is validated for not being empty</li>
+         * <li>the required indicator will be displayed if the value of this
+         * field at validation time is equal to what
+         * {@link HasValue#getEmptyValue()} returns</li>
          * </ol>
          * For localizing the error message, use
          * {@link #asRequired(ErrorMessageProvider)}.
-         * <p>
-         * *Value not being the equal to what {@link HasValue#getEmptyValue()}
-         * returns.
          *
          * @see #asRequired(ErrorMessageProvider)
          * @see HasValue#setRequiredIndicatorVisible(boolean)
@@ -511,11 +510,11 @@ public class Binder<BEAN> implements Serializable {
         /**
          * Sets the field to be required. This means two things:
          * <ol>
-         * <li>the required indicator is visible</li>
-         * <li>the field value is validated for not being empty*</li>
+         * <li>the field value is validated for not being empty</li>
+         * <li>the required indicator will be displayed if the value of this
+         * field at validation time is equal to what
+         * {@link HasValue#getEmptyValue()} returns</li>
          * </ol>
-         * *Value not being the equal to what {@link HasValue#getEmptyValue()}
-         * returns.
          *
          * @see HasValue#setRequiredIndicatorVisible(boolean)
          * @see HasValue#isEmpty()
@@ -1609,6 +1608,9 @@ public class Binder<BEAN> implements Serializable {
      * level validators if a bean is currently set with
      * {@link #setBean(Object)}, and returns whether any of the validators
      * failed.
+     * <p>
+     * <b>Note:</b> Calling this method will not trigger status change events,
+     * unlike {@link #validate()}.
      *
      * @return whether this binder is in a valid state
      * @throws IllegalStateException

diff --git a/server/src/main/java/com/vaadin/ui/Grid.java b/server/src/main/java/com/vaadin/ui/Grid.java
index 663df20b88993ef5f805024b22ffb282319e828b..ceeec79ac1f75d8fabc8f60c00a1c7cb57f13e69 100644 (file)
--- a/server/src/main/java/com/vaadin/ui/Grid.java
+++ b/server/src/main/java/com/vaadin/ui/Grid.java
@@ -4370,8 +4370,6 @@ public class Grid<T> extends AbstractListing<T> implements HasComponents,
      * @param providers
      *            list of {@link DeclarativeValueProvider}s to store the data of
      *            each column to
-     *
-     * @since 8.1
      */
     protected void readData(Element body,
             List<DeclarativeValueProvider<T>> providers) {