symfony
diff --git a/‎cookbook/security/api_key_authentication.rst
Copy file name to clipboardExpand all lines: cookbook/security/api_key_authentication.rst
+5Lines changed: 5 additions & 0 deletions b/‎cookbook/security/api_key_authentication.rst
Copy file name to clipboardExpand all lines: cookbook/security/api_key_authentication.rst
+5Lines changed: 5 additions & 0 deletions
diff --git a/‎cookbook/service_container/shared.rst
Copy file name to clipboardExpand all lines: cookbook/service_container/shared.rst
+1-1Lines changed: 1 addition & 1 deletion b/‎cookbook/service_container/shared.rst
Copy file name to clipboardExpand all lines: cookbook/service_container/shared.rst
+1-1Lines changed: 1 addition & 1 deletion
diff --git a/‎reference/constraints/Valid.rst
Copy file name to clipboardExpand all lines: reference/constraints/Valid.rst
+7-1Lines changed: 7 additions & 1 deletion b/‎reference/constraints/Valid.rst
Copy file name to clipboardExpand all lines: reference/constraints/Valid.rst
+7-1Lines changed: 7 additions & 1 deletion
@@ -128,6 +128,11 @@ will cause authentication to fail. You might want to return ``null`` instead
 to just skip the authentication, so Symfony can fallback to another authentication
 method, if any.
 
+.. caution::
+
+    In case you return ``null`` from your ``createToken()`` method, be sure to enable
+    ``anonymous`` in you firewall. This way you'll be able to get an ``AnonymousToken``.
+
 2. supportsToken
 ~~~~~~~~~~~~~~~~
 
 
@@ -36,9 +36,9 @@ in your service definition:
 
     .. code-block:: php
 
+        // app/config/services.php
         use Symfony\Component\DependencyInjection\Definition;
 
-        // app/config/services.php
         $definition = new Definition('...');
         $definition->setShared(false);
 
 
@@ -9,7 +9,7 @@ an object and all sub-objects associated with it.
 | Applies to     | :ref:`property or method <validation-property-target>`              |
 +----------------+---------------------------------------------------------------------+
 | Options        | - `traverse`_                                                       |
-|                | - `deep`_                                                           |
+|                | - `deep`_ (deprecated as of 2.5)                                    |
 |                | - `payload`_                                                        |
 +----------------+---------------------------------------------------------------------+
 | Class          | :class:`Symfony\\Component\\Validator\\Constraints\\Valid`          |
@@ -271,6 +271,12 @@ set to ``true``.
 deep
 ~~~~
 
+.. caution::
+
+    The ``deep`` option was deprecated in Symfony 2.5 and will be removed
+    in Symfony 3.0. When traversing arrays, nested arrays are always traversed.
+    When traversing nested objects, their traversal strategy is used.
+
 **type**: ``boolean`` **default**: ``false``
 
 If this constraint is applied to a property that holds an array of objects,