minor #11483 fix some docblocks (xabbuh)

This PR was merged into the 2.3 branch.

Discussion
----------

fix some docblocks

| Q             | A
| ------------- | ---
| Bug fix?      | yes
| New feature?  | no
| BC breaks?    | no
| Deprecations? | no
| Tests pass?   | yes
| Fixed tickets |
| License       | MIT
| Doc PR        |

Commits
-------

1775da5 fix some docblocks

Author: fabpot

Acl/Dbal/MutableAclProvider.php

@@ -801,12 +801,12 @@ private function updateNewFieldAceProperty($name, array $changes)
     }
 
     /**
-     * This process old entries changes on an ACE related property (classFieldAces, or objectFieldAces).
+     * This processes old entries changes on an ACE related property (classFieldAces, or objectFieldAces).
      *
      * @param string $name
-     * @param array $changes
+     * @param array  $changes
      */
-    private function updateOldFieldAceProperty($ane, array $changes)
+    private function updateOldFieldAceProperty($name, array $changes)
     {
         $currentIds = array();
         foreach ($changes[1] as $field => $new) {

Core/Encoder/BCryptPasswordEncoder.php

@@ -61,6 +61,8 @@ public function __construct($cost)
      *
      * @return string The encoded password
      *
+     * @throws BadCredentialsException when the given password is too long
+     *
      * @link http://lxr.php.net/xref/PHP_5_5/ext/standard/password.c#111
      */
     public function encodePassword($raw, $salt)

Core/Encoder/BasePasswordEncoder.php

@@ -89,6 +89,8 @@ protected function comparePasswords($password1, $password2)
     /**
      * Checks if the password is too long.
      *
+     * @param string $password The password to check
+     *
      * @return bool    true if the password is too long, false otherwise
      */
     protected function isPasswordTooLong($password)