Merge pull request #3203 from tjwudi/patch-3

Clarify property descriptor in add_request_method

1 files changed, 4 insertions, 3 deletions

diff --git a/pyramid/config/factories.py b/pyramid/config/factories.py
index c8633cc47..202c3ef61 100644
--- a/pyramid/config/factories.py
+++ b/pyramid/config/factories.py
@@ -144,9 +144,10 @@ class FactoriesConfiguratorMixin(object):
 
         When adding a property to the request, ``callable`` can either
         be a callable that accepts the request as its single positional
-        parameter, or it can be a property descriptor. If ``name`` is
-        ``None``, the name of the property will be computed from the
-        name of the ``callable``.
+        parameter, or it can be a property descriptor. If ``callable`` is
+        a property descriptor, it has to be an instance of a class which is
+        a subclass of ``property``. If ``name`` is ``None``, the name of
+        the property will be computed from the name of the ``callable``.
 
         If the ``callable`` is a property descriptor a ``ValueError``
         will be raised if ``name`` is ``None`` or ``reify`` is ``True``.