- improve documentation for return_defaults() and returned_defaults. [ticket:2852]

1 files changed, 9 insertions, 1 deletions

diff --git a/lib/sqlalchemy/engine/result.py b/lib/sqlalchemy/engine/result.py
index 93c7d3b6b..3a613ef5a 100644
--- a/lib/sqlalchemy/engine/result.py
+++ b/lib/sqlalchemy/engine/result.py
@@ -627,10 +627,18 @@ class ResultProxy(object):
     @property
     def returned_defaults(self):
         """Return the values of default columns that were fetched using
-        the ``returned_defaults`` feature.
+        the :meth:`.ValuesBase.return_defaults` feature.
+
+        The value is an instance of :class:`.RowProxy`, or ``None``
+        if :meth:`.ValuesBase.return_defaults` was not used or if the
+        backend does not support RETURNING.
 
         .. versionadded:: 0.9.0
 
+        .. seealso::
+
+            :meth:`.ValuesBase.return_defaults`
+
         """
         return self.context.returned_defaults