From e6c8dd57270cb5deed493ddac95618a5da7751d0 Mon Sep 17 00:00:00 2001
From: David Ham <David,Ham@imperial.ac.uk>
Date: Mon, 12 Aug 2013 19:26:37 +0100
Subject: [PATCH] Create a derivative of the DocstringSignatureMixin which
 strips signature strings from attributes. This scenario can occur when using
 Cython and turning methods into attributes with an @property decorator.

---
 sphinx/ext/autodoc.py | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/sphinx/ext/autodoc.py b/sphinx/ext/autodoc.py
index 555a31066..53c7a2506 100644
--- a/sphinx/ext/autodoc.py
+++ b/sphinx/ext/autodoc.py
@@ -924,6 +924,20 @@ class DocstringSignatureMixin(object):
                 self.args, self.retann = result
         return Documenter.format_signature(self)
 
+class DocstringStripSignatureMixin(DocstringSignatureMixin):
+    """
+    Mixin for AttributeDocumenter to provide the
+    feature of stripping any function signature from the docstring.
+    """
+    def format_signature(self):
+        if self.args is None and self.env.config.autodoc_docstring_signature:
+            # only act if a signature is not explicitly given already, and if
+            # the feature is enabled
+            result = self._find_signature()
+            if result is not None:
+                self.retann = result[1]
+        return Documenter.format_signature(self)
+    
 
 class FunctionDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter):
     """
@@ -1188,7 +1202,7 @@ class MethodDocumenter(DocstringSignatureMixin, ClassLevelDocumenter):
         pass
 
 
-class AttributeDocumenter(ClassLevelDocumenter):
+class AttributeDocumenter(DocstringStripSignatureMixin,ClassLevelDocumenter):
     """
     Specialized Documenter subclass for attributes.
     """