Merge pull request #16334 from anntzer/depprop

timhoffm · web-flow · commit c58ca603189f · 2020-01-26T19:32:36.000+01:00
Fix doc regarding deprecation of properties.
diff --git a/lib/matplotlib/cbook/deprecation.py b/lib/matplotlib/cbook/deprecation.py
@@ -115,9 +115,9 @@ def deprecated(since, *, message='', name='', alternative='', pending=False,
     Decorator to mark a function, a class, or a property as deprecated.
 
     When deprecating a classmethod, a staticmethod, or a property, the
-    ``@deprecated`` decorator should go *under* the ``@classmethod``, etc.
-    decorator (i.e., `deprecated` should directly decorate the underlying
-    callable).
+    ``@deprecated`` decorator should go *under* ``@classmethod`` and
+    ``@staticmethod`` (i.e., `deprecated` should directly decorate the
+    underlying callable), but *over* ``@property``.
 
     Parameters
     ----------
