API: rename quick_axes -> gna

tacaswell · tacaswell · commit e398ad85038e · 2015-08-30T17:28:02.000-04:00
In phone conversation with @efiring he suggesting changing 'quick_axes' to `gna` for 'get new axes' in analogy and contrast to `gca` -> 'get current axes (and create one if you have to)'.
diff --git a/doc/users/whats_new/2015-07-30_ensure_ax.rst b/doc/users/whats_new/2015-07-30_ensure_ax.rst
@@ -1,5 +1,5 @@
-Decorators to ensure an Axes exists & ``plt.quick_axes``
---------------------------------------------------------
+Decorators to ensure an Axes exists & ``plt.gna``
+-------------------------------------------------
 
 Added a top-level function to `pyplot` to create a single axes
 figure and return the `Axes` object.
@@ -15,4 +15,4 @@ positional argument and returns a function which allows the axes to be
 passed either as the first positional argument or as a kwarg.  If the
 `Axes` is not provided either gets the current axes (via `plt.gca()`)
 for `ensure_ax` and `ensure_ax_meth` or creating a new single-axes figure
-(via `plt.quick_axes`) for `ensure_new_ax`
+(via `plt.gna`) for `ensure_new_ax`
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -287,7 +287,7 @@ def inner(*args, **kwargs):
             ax = args[0]
             args = args[1:]
         else:
-            ax = quick_axes()
+            ax = gna()
         return func(ax, *args, **kwargs)
     pre_doc = inner.__doc__
     if pre_doc is None:
@@ -1385,7 +1385,7 @@ def subplots(nrows=1, ncols=1, sharex=False, sharey=False, squeeze=True,
     return ret
 
 
-def quick_axes(figsize=None, tight_layout=False):
+def gna(figsize=None, tight_layout=False):
     """
     Create a single new axes in a new figure.
 
