ENH: change name to set_loglevel

jklymak · jklymak · commit a3b9635af273 · 2019-01-21T13:22:57.000-08:00
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -451,7 +451,7 @@ Then they will receive messages like::
 More straight forward helper methods are available to end-users as well::
 
   import matplotlib.pyplot as plt
-  plt.verbose()  # or plt.debug()
+  plt.set_loglevel(level='info')  # or plt.set_loglevel(level='debug')
 
 Which logging level to use?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
diff --git a/doc/faq/troubleshooting_faq.rst b/doc/faq/troubleshooting_faq.rst
@@ -124,7 +124,7 @@ provide the following information in your e-mail to the `mailing list
   functions::
 
     import matplotlib.pyplot as plt
-    plt.verbose()  # or plt.debug()
+    plt.set_loglevel(level='info')  # or plt.set_loglevel(level='debug')
 
 
   If you want to put full debugging hooks in your own code, including
diff --git a/doc/users/next_whats_new/pyplot_verbose.rst b/doc/users/next_whats_new/pyplot_verbose.rst
@@ -4,4 +4,4 @@ New methods for verbose logging
 -------------------------------
 
 If more debugging information is required, the user can call
-the `.pyplot.verbose` or `.pyplot.debug` methods.
+the `.pyplot.set_loglevel` method.
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -207,7 +207,7 @@ def _check_versions():
     sys.argv = ['modpython']
 
 
-def verbose(level='info'):
+def set_loglevel(level='info'):
     """
     Shortcut to set the logging level of the logging module.
 
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1997,7 +1997,7 @@ def colormaps():
     return sorted(cm.cmap_d)
 
 
-def verbose(level='info'):
+def set_loglevel(level='info'):
     """
     Shortcut to set the debugging level of the logging module.
 
@@ -2020,24 +2020,7 @@ def verbose(level='info'):
         _log.setLevel(logging.DEBUG)  # or logging.WARNING, logging.INFO
 
     """
-    matplotlib.verbose(level=level)
-
-
-def debug():
-    """
-    Shortcut to set the debugging level of the logging module to DEBUG
-
-    Notes
-    -----
-    This is the same as the standard python `logging` module::
-
-        import logging
-
-        _log = logging.getLogger(__name__)
-        _log.setLevel(logging.DEBUG)
-
-    """
-    matplotlib.verbose(level='debug')
+    matplotlib.set_loglevel(level=level)
 
 
 def _setup_pyplot_info_docstrings():
