Cleanup @return annotations

Author: nicolas-grekas

ConstraintViolationList.php

@@ -184,7 +184,7 @@ public function offsetUnset($offset)
      *
      * @param string|string[] $codes The codes to find
      *
-     * @return static new instance which contains only specific errors
+     * @return static
      */
     public function findByCodes($codes)
     {

Mapping/ClassMetadataInterface.php

@@ -91,8 +91,7 @@ public function hasPropertyMetadata(string $property);
      *
      * @param string $property The property name
      *
-     * @return PropertyMetadataInterface[] A list of metadata instances. Empty if
-     *                                     no metadata exists for the property.
+     * @return PropertyMetadataInterface[]
      */
     public function getPropertyMetadata(string $property);
 

Mapping/Loader/XmlFileLoader.php

@@ -12,6 +12,7 @@
 namespace Symfony\Component\Validator\Mapping\Loader;
 
 use Symfony\Component\Config\Util\XmlUtils;
+use Symfony\Component\Validator\Constraint;
 use Symfony\Component\Validator\Exception\MappingException;
 use Symfony\Component\Validator\Mapping\ClassMetadata;
 
@@ -68,7 +69,7 @@ public function getMappedClasses()
      *
      * @param \SimpleXMLElement $nodes The XML nodes
      *
-     * @return array The Constraint instances
+     * @return Constraint[]
      */
     protected function parseConstraints(\SimpleXMLElement $nodes)
     {

Mapping/Loader/YamlFileLoader.php

@@ -11,6 +11,7 @@
 
 namespace Symfony\Component\Validator\Mapping\Loader;
 
+use Symfony\Component\Validator\Constraint;
 use Symfony\Component\Validator\Mapping\ClassMetadata;
 use Symfony\Component\Yaml\Exception\ParseException;
 use Symfony\Component\Yaml\Parser as YamlParser;
@@ -76,7 +77,7 @@ public function getMappedClasses()
      *
      * @param array $nodes The YAML nodes
      *
-     * @return array An array of values or Constraint instances
+     * @return array<array|scalar|Constraint>
      */
     protected function parseNodes(array $nodes)
     {

Mapping/MemberMetadata.php

@@ -158,7 +158,7 @@ public function isPrivate($objectOrClassName)
      *
      * @param object|string $objectOrClassName The object or the class name
      *
-     * @return \ReflectionMethod|\ReflectionProperty The reflection instance
+     * @return \ReflectionMethod|\ReflectionProperty
      */
     public function getReflectionMember($objectOrClassName)
     {
@@ -177,7 +177,7 @@ public function getReflectionMember($objectOrClassName)
      *
      * @param object|string $objectOrClassName The object or the class name
      *
-     * @return \ReflectionMethod|\ReflectionProperty The reflection instance
+     * @return \ReflectionMethod|\ReflectionProperty
      */
     abstract protected function newReflectionMember($objectOrClassName);
 

Mapping/MetadataInterface.php

@@ -51,7 +51,7 @@ public function getTraversalStrategy();
     /**
      * Returns all constraints of this element.
      *
-     * @return Constraint[] A list of Constraint instances
+     * @return Constraint[]
      */
     public function getConstraints();