minor #16130 Fix docblocks about callables (nicolas-grekas)

This PR was merged into the 2.3 branch.

Discussion
----------

Fix docblocks about callables

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

Commits
-------

a25beb6 Fix docblocks about callables

src/Symfony/Component/Finder/Iterator/CustomFilterIterator.php

@@ -26,8 +26,8 @@ class CustomFilterIterator extends FilterIterator
     /**
      * Constructor.
      *
-     * @param \Iterator $iterator The Iterator to filter
+     * @param \Iterator  $iterator The Iterator to filter
-     * @param array     $filters  An array of PHP callbacks
+     * @param callable[] $filters  An array of PHP callbacks
      *
      * @throws \InvalidArgumentException
      */

src/Symfony/Component/HttpKernel/Controller/ControllerResolver.php

@@ -145,7 +145,7 @@ class ControllerResolver implements ControllerResolverInterface
      *
      * @param string $controller A Controller string
      *
-     * @return mixed A PHP callable
+     * @return callable A PHP callable
      *
      * @throws \InvalidArgumentException
      */

src/Symfony/Component/HttpKernel/Event/FilterControllerEvent.php

@@ -29,8 +29,6 @@ class FilterControllerEvent extends KernelEvent
 {
     /**
      * The current controller.
-     *
-     * @var callable
      */
     private $controller;
 

src/Symfony/Component/Process/Process.php

@@ -1015,7 +1015,7 @@ class Process
      *
      * @param callback|null $callback The user defined PHP callback
      *
-     * @return callback A PHP callable
+     * @return \Closure A PHP closure
      */
     protected function buildCallback($callback)
     {

src/Symfony/Component/Templating/PhpEngine.php

@@ -354,8 +354,8 @@ class PhpEngine implements EngineInterface, \ArrayAccess
     /**
      * Adds an escaper for the given context.
      *
-     * @param string $context The escaper context (html, js, ...)
+     * @param string   $context The escaper context (html, js, ...)
-     * @param mixed  $escaper A PHP callable
+     * @param callable $escaper A PHP callable
      */
     public function setEscaper($context, $escaper)
     {
@@ -368,7 +368,7 @@ class PhpEngine implements EngineInterface, \ArrayAccess
      *
      * @param string $context The context name
      *
-     * @return mixed $escaper A PHP callable
+     * @return callable $escaper A PHP callable
      *
      * @throws \InvalidArgumentException
      */

src/Symfony/Component/Translation/PluralizationRules.php

@@ -190,8 +190,8 @@ class PluralizationRules
     /**
      * Overrides the default plural rule for a given locale.
      *
-     * @param string $rule   A PHP callable
+     * @param callable $rule   A PHP callable
-     * @param string $locale The locale
+     * @param string   $locale The locale
      *
      * @throws \LogicException
      */