Improve the deprecation warning for axes.hold

Nathan Goldbaum · Nathan Goldbaum · commit 9af29900b318 · 2016-12-19T21:41:48.000-06:00
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -42,6 +42,10 @@
 is_string_like = cbook.is_string_like
 is_sequence_of_strings = cbook.is_sequence_of_strings
 
+_hold_msg = """axes.hold is deprecated.
+    See the API Changes document (http://matplotlib.org/api/api_changes.html)
+    for more details."""
+
 
 def _process_plot_format(fmt):
     """
@@ -1202,7 +1206,7 @@ def ishold(self):
 
         return self._hold
 
-    @cbook.deprecated("2.0")
+    @cbook.deprecated("2.0", message=_hold_msg)
     def hold(self, b=None):
         """
         Set the hold state
