Cleanup more @return annotations

Author: nicolas-grekas

Caster/Caster.php

@@ -42,7 +42,7 @@ class Caster
      *
      * @param bool $hasDebugInfo Whether the __debugInfo method exists on $obj or not
      *
-     * @return array The array-cast of the object, with prefixed dynamic properties
+     * @return array
      */
     public static function castObject(object $obj, string $class, bool $hasDebugInfo = false, string $debugClass = null): array
     {
@@ -119,7 +119,7 @@ public static function castObject(object $obj, string $class, bool $hasDebugInfo
      * @param string[] $listedProperties List of properties to exclude when Caster::EXCLUDE_VERBOSE is set, and to preserve when Caster::EXCLUDE_NOT_IMPORTANT is set
      * @param int      &$count           Set to the number of removed properties
      *
-     * @return array The filtered array
+     * @return array
      */
     public static function filter(array $a, int $filter, array $listedProperties = [], ?int &$count = 0): array
     {

Cloner/AbstractCloner.php

@@ -260,7 +260,7 @@ public function setMinDepth(int $minDepth)
      * @param mixed $var    Any PHP variable
      * @param int   $filter A bit field of Caster::EXCLUDE_* constants
      *
-     * @return Data The cloned variable represented by a Data object
+     * @return Data
      */
     public function cloneVar($var, int $filter = 0)
     {
@@ -297,7 +297,7 @@ public function cloneVar($var, int $filter = 0)
      *
      * @param mixed $var Any PHP variable
      *
-     * @return array The cloned variable represented in an array
+     * @return array
      */
     abstract protected function doClone($var);
 
@@ -306,7 +306,7 @@ abstract protected function doClone($var);
      *
      * @param bool $isNested True if the object is nested in the dumped structure
      *
-     * @return array The object casted as array
+     * @return array
      */
     protected function castObject(Stub $stub, bool $isNested)
     {
@@ -365,7 +365,7 @@ protected function castObject(Stub $stub, bool $isNested)
      *
      * @param bool $isNested True if the object is nested in the dumped structure
      *
-     * @return array The resource casted as array
+     * @return array
      */
     protected function castResource(Stub $stub, bool $isNested)
     {

Cloner/ClonerInterface.php

@@ -21,7 +21,7 @@ interface ClonerInterface
      *
      * @param mixed $var Any PHP variable
      *
-     * @return Data The cloned variable represented by a Data object
+     * @return Data
      */
     public function cloneVar($var);
 }

Cloner/Data.php

@@ -36,7 +36,7 @@ public function __construct(array $data)
     }
 
     /**
-     * @return string|null The type of the value
+     * @return string|null
      */
     public function getType()
     {
@@ -65,9 +65,11 @@ public function getType()
     }
 
     /**
+     * Returns a native representation of the original value.
+     *
      * @param array|bool $recursive Whether values should be resolved recursively or not
      *
-     * @return string|int|float|bool|array|Data[]|null A native representation of the original value
+     * @return string|int|float|bool|array|Data[]|null
      */
     public function getValue($recursive = false)
     {
@@ -256,7 +258,7 @@ public function withContext(array $context)
      *
      * @param string|int $key The key to seek to
      *
-     * @return static|null Null if the key is not set
+     * @return static|null
      */
     public function seek($key)
     {

Dumper/AbstractDumper.php

@@ -180,7 +180,7 @@ protected function echoLine(string $line, int $depth, string $indentPad)
     /**
      * Converts a non-UTF-8 string to UTF-8.
      *
-     * @return string|null The string converted to UTF-8
+     * @return string|null
      */
     protected function utf8Encode(?string $s)
     {

Dumper/CliDumper.php

@@ -435,7 +435,7 @@ protected function dumpKey(Cursor $cursor)
      * @param string $value The value being styled
      * @param array  $attr  Optional context information
      *
-     * @return string The value with style decoration
+     * @return string
      */
     protected function style(string $style, string $value, array $attr = [])
     {
@@ -511,7 +511,7 @@ protected function style(string $style, string $value, array $attr = [])
     }
 
     /**
-     * @return bool Tells if the current output stream supports ANSI colors or not
+     * @return bool
      */
     protected function supportsColors()
     {

Dumper/ContextProvider/ContextProviderInterface.php

@@ -19,7 +19,7 @@
 interface ContextProviderInterface
 {
     /**
-     * @return array|null Context data or null if unable to provide any context
+     * @return array|null
      */
     public function getContext(): ?array;
 }