Closes #1489: Removes use of ":annotation:" for attribute types in napoleon, as inline markup is not allowed

doc/ext/napoleon.rst

@@ -324,7 +324,8 @@ enabled in `conf.py`::
    **If False**::
 
        .. attribute:: attr1
-          :annotation: int
+
+          *int*
 
           Description of `attr1`
 

sphinx/ext/napoleon/__init__.py

@@ -151,7 +151,8 @@ class Config(object):
         **If False**::
 
             .. attribute:: attr1
-               :annotation: int
+
+               *int*
 
                Description of `attr1`
 

sphinx/ext/napoleon/docstring.py

@@ -428,7 +428,11 @@ class GoogleDocstring(UnicodeMixin):
             else:
                 lines.append('.. attribute:: ' + _name)
                 if _type:
-                    lines.append('   :annotation: ' + _type)
+                    lines.append('')
+                    if '`' in _type:
+                        lines.append('   %s' % _type)
+                    else:
+                        lines.append('   *%s*' % _type)
                 if _desc:
                     lines.extend([''] + self._indent(_desc, 3))
                 lines.append('')

tests/test_napoleon_docstring.py

@@ -205,6 +205,37 @@ This class should only be used by runtimes.
 """
         self.assertEqual(expected, actual)
 
+    def test_attributes_with_class_reference(self):
+        docstring = """\
+Attributes:
+    in_attr(:class:`numpy.ndarray`): super-dooper attribute
+"""
+
+        actual = str(GoogleDocstring(docstring))
+        expected = """\
+.. attribute:: in_attr
+
+   :class:`numpy.ndarray`
+
+   super-dooper attribute
+"""
+        self.assertEqual(expected, actual)
+
+        docstring = """\
+Attributes:
+    in_attr(numpy.ndarray): super-dooper attribute
+"""
+
+        actual = str(GoogleDocstring(docstring))
+        expected = """\
+.. attribute:: in_attr
+
+   *numpy.ndarray*
+
+   super-dooper attribute
+"""
+        self.assertEqual(expected, actual)
+
 
 class NumpyDocstringTest(BaseDocstringTest):
     docstrings = [(