minor #11468 Document the UserValueResolver (HypeMC)

This PR was merged into the 4.2 branch.

Discussion
----------

Document the UserValueResolver

Fixes #10595, followup to #11467.

**NOTE**: This PR has all the changes that #11467 has plus some symfony 4.2 specific additions, so #11467 should probably be merged first.

Commits
-------

b72a65e Document the UserValueResolver

Author: javiereguiluz

controller/argument_value_resolver.rst

@@ -45,14 +45,25 @@ Symfony ships with the following value resolvers in the
     argument list. When the action is called, the last (variadic) argument will
     contain all the values of this array.
 
-In addition, some official bundles provide other value resolvers:
+In addition, some components and official bundles provide other value resolvers:
+
+:class:`Symfony\\Component\\Security\\Http\\Controller\\UserValueResolver`
+    Injects the object that represents the current logged in user if type-hinted
+    with ``UserInterface``. Default value can be set to ``null`` in case
+    the controller can be accessed by anonymous users. It requires installing
+    the :doc:`Security component </components/security>`.
 
 :class:`Symfony\\Bundle\\SecurityBundle\\SecurityUserValueResolver`
     Injects the object that represents the current logged in user if type-hinted
     with ``UserInterface``. Default value can be set to ``null`` in case
     the controller can be accessed by anonymous users. It requires installing
     the `SecurityBundle`_.
 
+.. deprecated:: 4.1
+
+    The resolver was deprecated in Symfony 4.1 in favor of
+    `Symfony\\Component\\Security\\Http\\Controller\\UserValueResolver`.
+
 ``Psr7ServerRequestResolver``
     Injects a `PSR-7`_ compliant version of the current request if type-hinted
     with ``RequestInterface``, ``MessageInterface`` or ``ServerRequestInterface``.