Merge branch 'hotfix/146'

Close #146

Author: weierophinney

CHANGELOG.md

@@ -22,6 +22,8 @@ All notable changes to this project will be documented in this file, in reverse
 
 ### Fixed
 
+- [#146](https://github.com/zendframework/zend-code/pull/146) updates all `@return` annotations to reflect the correct types returned by each method.
+
 - [#144](https://github.com/zendframework/zend-code/pull/144) fixes the class generator such that it now resolves
   `setExtendedClass()` arguments to aliases provided to the generator.
 

src/Generator/ClassGenerator.php

@@ -743,7 +743,7 @@ public function addUse($use, $useAlias = null)
 
     /**
      * @param string $use
-     * @return self
+     * @return bool
      */
     public function hasUse($use)
     {

src/Generator/DocBlock/Tag/AbstractTypeableTag.php

@@ -50,7 +50,7 @@ public function __construct($types = [], $description = null)
 
     /**
      * @param string $description
-     * @return ReturnTag
+     * @return AbstractTypeableTag
      */
     public function setDescription($description)
     {
@@ -71,7 +71,7 @@ public function getDescription()
      * e.g. array('int', 'null') or "int|null"
      *
      * @param array|string $types
-     * @return ReturnTag
+     * @return AbstractTypeableTag
      */
     public function setTypes($types)
     {

src/Generator/DocBlock/Tag/AuthorTag.php

@@ -42,7 +42,7 @@ public function __construct($authorName = null, $authorEmail = null)
 
     /**
      * @param ReflectionTagInterface $reflectionTag
-     * @return ReturnTag
+     * @return AuthorTag
      * @deprecated Deprecated in 2.3. Use TagManager::createTagFromReflection() instead
      */
     public static function fromReflection(ReflectionTagInterface $reflectionTag)

src/Generator/DocBlock/Tag/ParamTag.php

@@ -37,7 +37,7 @@ public function __construct($variableName = null, $types = [], $description = nu
 
     /**
      * @param ReflectionTagInterface $reflectionTag
-     * @return ReturnTag
+     * @return ParamTag
      * @deprecated Deprecated in 2.3. Use TagManager::createTagFromReflection() instead
      */
     public static function fromReflection(ReflectionTagInterface $reflectionTag)
@@ -75,7 +75,7 @@ public function getVariableName()
 
     /**
      * @param string $datatype
-     * @return ReturnTag
+     * @return ParamTag
      * @deprecated Deprecated in 2.3. Use setTypes() instead
      */
     public function setDatatype($datatype)

src/Generator/DocBlockGenerator.php

@@ -49,6 +49,9 @@ class DocBlockGenerator extends AbstractGenerator
      */
     protected $wordwrap = true;
 
+    /**
+     * @var TagManager
+     */
     protected static $tagManager;
 
     /**
@@ -107,6 +110,9 @@ public static function fromArray(array $array)
         return $docBlock;
     }
 
+    /**
+     * @return TagManager
+     */
     protected static function getTagManager()
     {
         if (! isset(static::$tagManager)) {

src/Reflection/ClassReflection.php

@@ -50,7 +50,7 @@ public function getDeclaringFile()
     /**
      * Return the classes DocBlock reflection object
      *
-     * @return DocBlockReflection
+     * @return DocBlockReflection|false
      * @throws Exception\ExceptionInterface for missing DocBock or invalid reflection class
      */
     public function getDocBlock()
@@ -70,7 +70,7 @@ public function getDocBlock()
 
     /**
      * @param  AnnotationManager $annotationManager
-     * @return AnnotationCollection
+     * @return AnnotationCollection|false
      */
     public function getAnnotations(AnnotationManager $annotationManager)
     {
@@ -188,7 +188,7 @@ public function getMethods($filter = -1)
     /**
      * Returns an array of reflection classes of traits used by this class.
      *
-     * @return void|array
+     * @return null|array
      */
     public function getTraits()
     {

src/Reflection/DocBlock/Tag/MethodTag.php

@@ -78,7 +78,7 @@ public function initialize($tagDocblockLine)
     /**
      * Get return value type
      *
-     * @return void|string
+     * @return null|string
      * @deprecated 2.0.4 use getTypes instead
      */
     public function getReturnType()

src/Reflection/DocBlock/Tag/PropertyTag.php

@@ -64,7 +64,7 @@ public function initialize($tagDocblockLine)
     }
 
     /**
-     * @return void|string
+     * @return null|string
      * @deprecated 2.0.4 use getTypes instead
      */
     public function getType()

src/Reflection/DocBlockReflection.php

@@ -91,7 +91,6 @@ public static function export()
      * @param  Reflector|string $commentOrReflector
      * @param  null|DocBlockTagManager $tagManager
      * @throws Exception\InvalidArgumentException
-     * @return DocBlockReflection
      */
     public function __construct($commentOrReflector, DocBlockTagManager $tagManager = null)
     {