warnings

Author: OceanWolf

lib/matplotlib/backend_managers.py

@@ -57,6 +57,9 @@ class ToolManager(object):
     """
 
     def __init__(self, canvas):
+        warnings.warn('Treat the new Tool classes introduced in v1.5 as ' +
+                       'experimental for now, the API will likely change in ' +
+                       'version 2.1 and perhaps the rcParam as well')
         self.canvas = canvas
 
         self._key_press_handler_id = self.canvas.mpl_connect(

lib/matplotlib/backend_tools.py

@@ -72,6 +72,9 @@ class ToolBase(object):
     """
 
     def __init__(self, toolmanager, name):
+        warnings.warn('Treat the new Tool classes introduced in v1.5 as ' +
+                       'experimental for now, the API will likely change in ' +
+                       'version 2.1, and some tools might change name')
         self._name = name
         self._figure = None
         self.toolmanager = toolmanager