From ac73dd5197d2d7e58f1f069e2c28c658498c8cbe Mon Sep 17 00:00:00 2001
From: Henri Sara <henri.sara@gmail.com>
Date: Thu, 27 Apr 2017 13:46:05 +0300
Subject: Add since tags for 8.1

---
 .../java/com/vaadin/shared/ApplicationConstants.java    | 17 +++++++++++++++++
 .../main/java/com/vaadin/shared/VBrowserDetails.java    |  8 ++++++++
 .../main/java/com/vaadin/shared/VaadinUriResolver.java  |  1 +
 .../shared/ui/nativeselect/NativeSelectState.java       |  6 ++++++
 4 files changed, 32 insertions(+)

(limited to 'shared')

diff --git a/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java b/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java
index 286cd07760..963353dcd8 100644
--- a/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java
+++ b/shared/src/main/java/com/vaadin/shared/ApplicationConstants.java
@@ -45,6 +45,13 @@ public class ApplicationConstants implements Serializable {
     public static final String PUBLISHED_PROTOCOL_NAME = "published";
     public static final String PUBLISHED_PROTOCOL_PREFIX = PUBLISHED_PROTOCOL_NAME
             + "://";
+    /**
+     * An internal protocol used for referencing frontend resources.
+     *
+     * @see #FRONTEND_URL
+     *
+     * @since 8.1
+     */
     public static final String FRONTEND_PROTOCOL_PREFIX = "frontend://";
 
     /**
@@ -106,6 +113,8 @@ public class ApplicationConstants implements Serializable {
      * <p>
      * By default, this is "vaadin://es6" ("vaadin://es5" for browsers which
      * does not support ES6).
+     *
+     * @since 8.1
      */
     public static final String FRONTEND_URL = "frontendUrl";
 
@@ -199,18 +208,24 @@ public class ApplicationConstants implements Serializable {
     /**
      * Configuration name for the {@literal frontend://} URL when using a
      * browser which is not ES6 compatible (i.e. IE11 or Safari 9).
+     *
+     * @since 8.1
      */
     public static final String FRONTEND_URL_ES5 = "frontend.url.es5";
 
     /**
      * Configuration name for the {@literal frontend://} URL when using an ES6
      * compatible browser.
+     *
+     * @since 8.1
      */
     public static final String FRONTEND_URL_ES6 = "frontend.url.es6";
 
     /**
      * Default value of the configuration of the build URL of ES6 web
      * components.
+     *
+     * @since 8.1
      */
     public static final String FRONTEND_URL_ES6_DEFAULT_VALUE = VAADIN_PROTOCOL_PREFIX
             + "frontend/es6/";
@@ -218,6 +233,8 @@ public class ApplicationConstants implements Serializable {
     /**
      * Default value of the configuration of the build URL of ES5 web
      * components.
+     *
+     * @since 8.1
      */
     public static final String FRONTEND_URL_ES5_DEFAULT_VALUE = VAADIN_PROTOCOL_PREFIX
             + "frontend/es5/";
diff --git a/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java b/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java
index 4fac5db636..6933d32326 100644
--- a/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java
+++ b/shared/src/main/java/com/vaadin/shared/VBrowserDetails.java
@@ -365,6 +365,7 @@ public class VBrowserDetails implements Serializable {
      * iOS).
      *
      * @return true if it is Safari or running on IOS, false otherwise
+     * @since 8.1
      */
     public boolean isSafariOrIOS() {
         return isSafari() || isIOS();
@@ -602,6 +603,13 @@ public class VBrowserDetails implements Serializable {
         return false;
     }
 
+    /**
+     * Checks whether the browser should support ES6 based on its vendor and
+     * version number.
+     *
+     * @return true if the browser supports ES6
+     * @since 8.1
+     */
     public boolean isEs6Supported() {
         if (isTooOldToFunctionProperly()) {
             return false;
diff --git a/shared/src/main/java/com/vaadin/shared/VaadinUriResolver.java b/shared/src/main/java/com/vaadin/shared/VaadinUriResolver.java
index 6c02028d8b..e8ec60b14b 100644
--- a/shared/src/main/java/com/vaadin/shared/VaadinUriResolver.java
+++ b/shared/src/main/java/com/vaadin/shared/VaadinUriResolver.java
@@ -189,6 +189,7 @@ public abstract class VaadinUriResolver implements Serializable {
      *
      * @return the absolute or relative URL to the frontend files, ending with a
      *         slash '/'
+     * @since 8.1
      */
     protected abstract String getFrontendUrl();
 }
diff --git a/shared/src/main/java/com/vaadin/shared/ui/nativeselect/NativeSelectState.java b/shared/src/main/java/com/vaadin/shared/ui/nativeselect/NativeSelectState.java
index 86872298e6..450b69db67 100644
--- a/shared/src/main/java/com/vaadin/shared/ui/nativeselect/NativeSelectState.java
+++ b/shared/src/main/java/com/vaadin/shared/ui/nativeselect/NativeSelectState.java
@@ -44,6 +44,12 @@ public class NativeSelectState extends AbstractSingleSelectState {
      */
     public String emptySelectionCaption = "";
 
+    /**
+     * The number of items that are visible. If only one item is visible, then
+     * the box will be displayed as a drop-down list.
+     *
+     * @since 8.1
+     */
     @DelegateToWidget
     public int visibleItemCount = 1;
 
-- 
cgit v1.2.3