MAGETWO-67205: Add @api Annotation in Stdlib framework library

Author: buskamuza

lib/internal/Magento/Framework/Stdlib/Cookie/CookieSizeLimitReachedException.php

@@ -13,6 +13,8 @@
  *
  * Limits can include the amount of data stored in an individual cookie as well as the number of cookies
  * set for the domain.
+ *
+ * @api
  */
 class CookieSizeLimitReachedException extends LocalizedException
 {

lib/internal/Magento/Framework/Stdlib/Cookie/FailureToSendException.php

@@ -10,6 +10,8 @@
 /**
  * FailureToSendException is thrown when trying to set a cookie but the response has already been sent, making it
  * impossible to send any cookie information back to the client.
+ *
+ * @api
  */
 class FailureToSendException extends LocalizedException
 {

lib/internal/Magento/Framework/Stdlib/Cookie/PublicCookieMetadata.php

@@ -9,6 +9,7 @@
 /**
  * Class PublicCookieMetadata
  *
+ * @api
  */
 class PublicCookieMetadata extends CookieMetadata
 {
@@ -41,7 +42,6 @@ public function setDurationOneYear()
      * The cookie duration can be translated into an expiration date at the time the cookie is sent.
      *
      * @return int|null Time in seconds.
-     * @api
      */
     public function getDuration()
     {
@@ -53,7 +53,6 @@ public function getDuration()
      *
      * @param bool $httpOnly
      * @return $this
-     * @api
      */
     public function setHttpOnly($httpOnly)
     {
@@ -65,7 +64,6 @@ public function setHttpOnly($httpOnly)
      *
      * @param bool $secure
      * @return $this
-     * @api
      */
     public function setSecure($secure)
     {

lib/internal/Magento/Framework/Stdlib/Cookie/SensitiveCookieMetadata.php

@@ -13,6 +13,8 @@
  *
  * The class has only methods extended from CookieMetadata
  * as path and domain are only data to be exposed by SensitiveCookieMetadata
+ *
+ * @api
  */
 class SensitiveCookieMetadata extends CookieMetadata
 {

lib/internal/Magento/Framework/Stdlib/DateTime/DateTime.php

@@ -9,7 +9,7 @@
 /**
  * Date conversion model
  *
- * @author Magento Core Team <core@magentocommerce.com>
+ * @api
  */
 class DateTime
 {
@@ -39,7 +39,6 @@ public function __construct(TimezoneInterface $localeDate)
      *
      * @param  string|null $timezone
      * @return int offset between timezone and gmt
-     * @api
      */
     public function calculateOffset($timezone = null)
     {
@@ -85,7 +84,6 @@ public function gmtDate($format = null, $input = null)
      * @param  string $format
      * @param  int|string $input date in GMT timezone
      * @return string
-     * @api
      */
     public function date($format = null, $input = null)
     {
@@ -148,7 +146,6 @@ public function timestamp($input = null)
      *
      * @param  string $type
      * @return int
-     * @api
      */
     public function getGmtOffset($type = 'seconds')
     {

lib/internal/Magento/Framework/Stdlib/DateTime/Filter/Date.php

@@ -1,15 +1,17 @@
 <?php
 /**
- * Date filter. Converts date from localized to internal format.
- *
  * Copyright © 2013-2017 Magento, Inc. All rights reserved.
  * See COPYING.txt for license details.
  */
 namespace Magento\Framework\Stdlib\DateTime\Filter;
 
 use Magento\Framework\Stdlib\DateTime\TimezoneInterface;
-use Magento\Framework\Phrase;
 
+/**
+ * Date filter. Converts date from localized to internal format.
+ *
+ * @api
+ */
 class Date implements \Zend_Filter_Interface
 {
     /**

lib/internal/Magento/Framework/Stdlib/DateTime/Filter/DateTime.php

@@ -1,14 +1,15 @@
 <?php
 /**
- * Date/Time filter. Converts datetime from localized to internal format.
- *
  * Copyright © 2013-2017 Magento, Inc. All rights reserved.
  * See COPYING.txt for license details.
  */
 namespace Magento\Framework\Stdlib\DateTime\Filter;
 
-use Magento\Framework\Phrase;
-
+/**
+ * Date/Time filter. Converts datetime from localized to internal format.
+ *
+ * @api
+ */
 class DateTime extends Date
 {
     /**

lib/internal/Magento/Framework/Stdlib/DateTime/Timezone/Validator.php

@@ -8,6 +8,9 @@
 use Magento\Framework\Exception\ValidatorException;
 use Magento\Framework\Phrase;
 
+/**
+ * @api
+ */
 class Validator
 {
     /**

lib/internal/Magento/Framework/Stdlib/README.md

@@ -1,2 +1,2 @@
 The Stdlib library contains utility classes that extend or relate to base PHP classes. Modules should use the CookieManager to get and set cookies instead of the built-in cookie functions for improved security.
-Other classes provide convenience methods for dealing with arrays, boolean, date/time, and strings.
+Other classes provide convenient methods for dealing with arrays, boolean, date/time, and strings.