MAGETWO-67610: Add @api Annotation in Cache Framework

Author: buskamuza

lib/internal/Magento/Framework/App/Cache/Manager.php

@@ -10,6 +10,8 @@
 
 /**
  * Cache status manager
+ *
+ * @api
  */
 class Manager
 {

lib/internal/Magento/Framework/App/Cache/Type/Config.php

@@ -4,14 +4,14 @@
  * See COPYING.txt for license details.
  */
 
-/**
- * System / Cache Management / Cache type "Configuration"
- */
 namespace Magento\Framework\App\Cache\Type;
 
 use Magento\Framework\Cache\Frontend\Decorator\TagScope;
 use Magento\Framework\Config\CacheInterface;
 
+/**
+ * System / Cache Management / Cache type "Configuration"
+ */
 class Config extends TagScope implements CacheInterface
 {
     /**

lib/internal/Magento/Framework/App/Cache/Type/FrontendPool.php

@@ -10,6 +10,8 @@
 
 /**
  * In-memory readonly pool of cache front-ends with enforced access control, specific to cache types
+ *
+ * @api
  */
 class FrontendPool
 {

lib/internal/Magento/Framework/Cache/Backend/Decorator/AbstractDecorator.php

@@ -4,11 +4,11 @@
  * See COPYING.txt for license details.
  */
 
+namespace Magento\Framework\Cache\Backend\Decorator;
+
 /**
  * Abstract decorator class for \Zend_Cache_Backend class and its descendants
  */
-namespace Magento\Framework\Cache\Backend\Decorator;
-
 abstract class AbstractDecorator extends \Zend_Cache_Backend implements \Zend_Cache_Backend_ExtendedInterface
 {
     /**

lib/internal/Magento/Framework/Cache/Backend/Decorator/Compression.php

@@ -4,13 +4,13 @@
  * See COPYING.txt for license details.
  */
 
+namespace Magento\Framework\Cache\Backend\Decorator;
+
 /**
  * Decorator class for compressing data before storing in cache
  *
  * @todo re-implement as a cache frontend decorator similarly to \Magento\Framework\Cache\Frontend\Decorator\*
  */
-namespace Magento\Framework\Cache\Backend\Decorator;
-
 class Compression extends \Magento\Framework\Cache\Backend\Decorator\AbstractDecorator
 {
     /**

lib/internal/Magento/Framework/Cache/Frontend/Decorator/Logger.php

@@ -4,14 +4,14 @@
  * See COPYING.txt for license details.
  */
 
-/**
- * Cache frontend decorator that logger of cache invalidate
- */
 namespace Magento\Framework\Cache\Frontend\Decorator;
 
 use Magento\Framework\Cache\FrontendInterface;
 use Magento\Framework\Cache\InvalidateLogger as LoggerHandler;
 
+/**
+ * Cache frontend decorator that logs cache invalidation actions
+ */
 class Logger extends Bare
 {
     /**

lib/internal/Magento/Framework/Cache/Frontend/Decorator/Profiler.php

@@ -4,11 +4,11 @@
  * See COPYING.txt for license details.
  */
 
+namespace Magento\Framework\Cache\Frontend\Decorator;
+
 /**
  * Cache frontend decorator that performs profiling of cache operations
  */
-namespace Magento\Framework\Cache\Frontend\Decorator;
-
 class Profiler extends \Magento\Framework\Cache\Frontend\Decorator\Bare
 {
     /**

lib/internal/Magento/Framework/Cache/Frontend/Decorator/TagScope.php

@@ -4,11 +4,13 @@
  * See COPYING.txt for license details.
  */
 
+namespace Magento\Framework\Cache\Frontend\Decorator;
+
 /**
  * Cache frontend decorator that limits the cleaning scope within a tag
+ *
+ * @api
  */
-namespace Magento\Framework\Cache\Frontend\Decorator;
-
 class TagScope extends \Magento\Framework\Cache\Frontend\Decorator\Bare
 {
     /**

lib/internal/Magento/Framework/Cache/FrontendInterface.php

@@ -4,11 +4,13 @@
  * See COPYING.txt for license details.
  */
 
+namespace Magento\Framework\Cache;
+
 /**
  * Interface of a cache frontend - an ultimate publicly available interface to an actual cache storage
+ *
+ * @api
  */
-namespace Magento\Framework\Cache;
-
 interface FrontendInterface
 {
     /**