TagHandler and CacheManager phpdoc cleanups

src/CacheInvalidator.php

@@ -59,6 +59,8 @@ class CacheInvalidator
     private $eventDispatcher;
 
     /**
+     * @deprecated This reference is only for BC and will be removed in version 2.0.
+     *
      * @var TagHandler
      */
     private $tagHandler;
@@ -115,6 +117,8 @@ public function supports($operation)
      * @param EventDispatcherInterface $eventDispatcher
      *
      * @return $this
+     *
+     * @throws \Exception When trying to override the event dispatcher.
      */
     public function setEventDispatcher(EventDispatcherInterface $eventDispatcher)
     {

src/Handler/TagHandler.php

@@ -82,10 +82,14 @@ public function getTagsHeaderValue()
      * This must be called before any response is sent to the client.
      *
      * @param array $tags List of tags to add.
+     *
+     * @return $this
      */
     public function addTags(array $tags)
     {
         $this->tags = array_merge($this->tags, $tags);
+
+        return $this;
     }
 
     /**