Document deprecation of supports{Attribute,Class}() methods

wouterj · wouterj · commit 0526ca09115d · 2015-11-28T17:16:39.000+01:00
diff --git a/components/security/authorization.rst b/components/security/authorization.rst
@@ -90,10 +90,10 @@ of :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterf
 which means they have to implement a few methods which allows the decision
 manager to use them:
 
-``supportsAttribute($attribute)``
+``supportsAttribute($attribute)`` (deprecated as of 2.8)
     will be used to check if the voter knows how to handle the given attribute;
 
-``supportsClass($class)``
+``supportsClass($class)`` (deprecated as of 2.8)
     will be used to check if the voter is able to grant or deny access for
     an object of the given class;
 
@@ -103,6 +103,12 @@ manager to use them:
     i.e. ``VoterInterface::ACCESS_GRANTED``, ``VoterInterface::ACCESS_DENIED``
     or ``VoterInterface::ACCESS_ABSTAIN``;
 
+.. note::
+
+    The ``supportsAttribute()`` and ``supportsClass()`` methods are deprecated
+    as of Symfony 2.8 and no longer required in 3.0. These methods should not
+    be called outside the voter class.
+
 The Security component contains some standard voters which cover many use
 cases:
 
