matplotlib
diff --git a/‎doc/users/whats_new/uptade_subplot2grid.rst
Copy file name to clipboard
+13Lines changed: 13 additions & 0 deletions b/‎doc/users/whats_new/uptade_subplot2grid.rst
Copy file name to clipboard
+13Lines changed: 13 additions & 0 deletions
diff --git a/‎lib/matplotlib/pyplot.py
Copy file name to clipboardExpand all lines: lib/matplotlib/pyplot.py
+2-1Lines changed: 2 additions & 1 deletion b/‎lib/matplotlib/pyplot.py
Copy file name to clipboardExpand all lines: lib/matplotlib/pyplot.py
+2-1Lines changed: 2 additions & 1 deletion
@@ -0,0 +1,13 @@
+New Firgure Parameter for subplot2grid
+--------------------------------------
+
+A ``fig`` parameter now exists for the method :func:`subplot2grid`.  This allows
+for the figure that the subplots will be created in to be specified.  If ``fig``
+is ``None`` (default) then the method will use the current figure retrieved by
+:func:`gcf`.
+
+Example
+```````
+::
+
+    subplot2grid(shape, loc, rowspan=1, colspan=1, fig=myfig)
@@ -1151,7 +1151,8 @@ def subplot2grid(shape, loc, rowspan=1, colspan=1, fig=None, **kwargs):
     """
     Create a subplot in a grid.  The grid is specified by *shape*, at
     location of *loc*, spanning *rowspan*, *colspan* cells in each
-    direction.  The index for loc is 0-based. ::
+    direction.  The index for loc is 0-based.  The current figure will
+    be used unless *fig* is specified. ::
 
       subplot2grid(shape, loc, rowspan=1, colspan=1)