Cleanup more @return annotations

Author: nicolas-grekas

Authentication/Provider/AuthenticationProviderInterface.php

@@ -38,7 +38,7 @@ interface AuthenticationProviderInterface extends AuthenticationManagerInterface
     /**
      * Checks whether this provider supports the given token.
      *
-     * @return bool true if the implementation supports the Token, false otherwise
+     * @return bool
      */
     public function supports(TokenInterface $token);
 }

Authentication/Provider/UserAuthenticationProvider.php

@@ -115,7 +115,7 @@ public function supports(TokenInterface $token)
     /**
      * Retrieves the user from an implementation-specific location.
      *
-     * @return UserInterface The user
+     * @return UserInterface
      *
      * @throws AuthenticationException if the credentials could not be validated
      */

Authentication/Token/AbstractToken.php

@@ -210,7 +210,7 @@ public function __unserialize(array $data): void
     /**
      * Returns the token attributes.
      *
-     * @return array The token attributes
+     * @return array
      */
     public function getAttributes()
     {
@@ -230,7 +230,7 @@ public function setAttributes(array $attributes)
     /**
      * Returns true if the attribute exists.
      *
-     * @return bool true if the attribute exists, false otherwise
+     * @return bool
      */
     public function hasAttribute(string $name)
     {
@@ -240,7 +240,7 @@ public function hasAttribute(string $name)
     /**
      * Returns an attribute value.
      *
-     * @return mixed The attribute value
+     * @return mixed
      *
      * @throws \InvalidArgumentException When attribute doesn't exist for this token
      */

Authentication/Token/TokenInterface.php

@@ -35,14 +35,14 @@ public function __toString();
     /**
      * Returns the user roles.
      *
-     * @return string[] The associated roles
+     * @return string[]
      */
     public function getRoleNames(): array;
 
     /**
      * Returns the user credentials.
      *
-     * @return mixed The user credentials
+     * @return mixed
      *
      * @deprecated since 5.4
      */
@@ -90,7 +90,7 @@ public function eraseCredentials();
     /**
      * Returns the token attributes.
      *
-     * @return array The token attributes
+     * @return array
      */
     public function getAttributes();
 
@@ -104,14 +104,14 @@ public function setAttributes(array $attributes);
     /**
      * Returns true if the attribute exists.
      *
-     * @return bool true if the attribute exists, false otherwise
+     * @return bool
      */
     public function hasAttribute(string $name);
 
     /**
      * Returns an attribute value.
      *
-     * @return mixed The attribute value
+     * @return mixed
      *
      * @throws \InvalidArgumentException When attribute doesn't exist for this token
      */

Authorization/AccessDecisionManagerInterface.php

@@ -26,7 +26,7 @@ interface AccessDecisionManagerInterface
      * @param array $attributes An array of attributes associated with the method being invoked
      * @param mixed $object     The object to secure
      *
-     * @return bool true if the access is granted, false otherwise
+     * @return bool
      */
     public function decide(TokenInterface $token, array $attributes, $object = null);
 }

Authorization/Voter/Voter.php

@@ -65,7 +65,7 @@ public function vote(TokenInterface $token, $subject, array $attributes)
      * @param string $attribute An attribute
      * @param mixed  $subject   The subject to secure, e.g. an object the user wants to access or any other PHP type
      *
-     * @return bool True if the attribute and subject are supported, false otherwise
+     * @return bool
      */
     abstract protected function supports(string $attribute, $subject);
 

Encoder/BasePasswordEncoder.php

@@ -60,7 +60,7 @@ protected function demergePasswordAndSalt(string $mergedPasswordSalt)
     /**
      * Merges a password and a salt.
      *
-     * @return string a merged password and salt
+     * @return string
      *
      * @throws \InvalidArgumentException
      */
@@ -83,7 +83,7 @@ protected function mergePasswordAndSalt(string $password, ?string $salt)
      * This method implements a constant-time algorithm to compare passwords to
      * avoid (remote) timing attacks.
      *
-     * @return bool true if the two passwords are the same, false otherwise
+     * @return bool
      */
     protected function comparePasswords(string $password1, string $password2)
     {
@@ -93,7 +93,7 @@ protected function comparePasswords(string $password1, string $password2)
     /**
      * Checks if the password is too long.
      *
-     * @return bool true if the password is too long, false otherwise
+     * @return bool
      */
     protected function isPasswordTooLong(string $password)
     {

Encoder/PasswordEncoderInterface.php

@@ -28,7 +28,7 @@ interface PasswordEncoderInterface
     /**
      * Encodes the raw password.
      *
-     * @return string The encoded password
+     * @return string
      *
      * @throws BadCredentialsException   If the raw password is invalid, e.g. excessively long
      * @throws \InvalidArgumentException If the salt is invalid
@@ -42,7 +42,7 @@ public function encodePassword(string $raw, ?string $salt);
      * @param string      $raw     A raw password
      * @param string|null $salt    The salt
      *
-     * @return bool true if the password is valid, false otherwise
+     * @return bool
      *
      * @throws \InvalidArgumentException If the salt is invalid
      */

Encoder/UserPasswordEncoderInterface.php

@@ -28,12 +28,12 @@ interface UserPasswordEncoderInterface
     /**
      * Encodes the plain password.
      *
-     * @return string The encoded password
+     * @return string
      */
     public function encodePassword(UserInterface $user, string $plainPassword);
 
     /**
-     * @return bool true if the password is valid, false otherwise
+     * @return bool
      */
     public function isPasswordValid(UserInterface $user, string $raw);
 

User/PasswordAuthenticatedUserInterface.php

@@ -24,7 +24,7 @@ interface PasswordAuthenticatedUserInterface
      *
      * Usually on authentication, a plain-text password will be compared to this value.
      *
-     * @return string|null The hashed password or null (if not set or erased)
+     * @return string|null
      */
     public function getPassword(): ?string;
 }