unittest.mock.PropertyMock return value and attributes are now standard MagicMocks
diff --git a/Doc/library/unittest.mock.rst b/Doc/library/unittest.mock.rst
index df1c41f..f00d29f 100644
--- a/Doc/library/unittest.mock.rst
+++ b/Doc/library/unittest.mock.rst
@@ -712,6 +712,17 @@
>>> mock_foo.mock_calls
[call(), call(6)]
+Because of the way mock attributes are stored you can't directly attach a
+`PropertyMock` to a mock object. Instead you can attach it to the mock type
+object::
+
+ >>> m = MagicMock()
+ >>> p = PropertyMock(return_value=3)
+ >>> type(m).foo = p
+ >>> m.foo
+ 3
+ >>> p.assert_called_once_with()
+
Calling
~~~~~~~