Add unobtrusive depreaction note to the first line of the docstring.

timhoffm · timhoffm · commit 313f65324627 · 2018-11-04T22:44:56.000+01:00
diff --git a/lib/matplotlib/cbook/deprecation.py b/lib/matplotlib/cbook/deprecation.py
@@ -247,7 +247,7 @@ def wrapper(*args, **kwargs):
         old_doc = inspect.cleandoc(old_doc or '').strip('\n')
 
         message = message.strip()
-        new_doc = ('{old_doc}\n'
+        new_doc = ('[*Deprecated*] {old_doc}\n'
                    '\n'
                    '.. deprecated:: {since}\n'
                    '   {message}'
