DOC/API: make subplot_kw and gridspec_kw kw only

tacaswell · tacaswell · commit cd5a6d6146c7 · 2020-02-28T17:22:10.000-05:00
Also fix grammar and rst markup
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -1576,27 +1576,27 @@ def subplots(self, nrows=1, ncols=1, sharex=False, sharey=False,
             # Returned axis array will be always 2-d, even if nrows=ncols=1.
             return axarr
 
-    def build_grid(self, layout, subplot_kw=None, gridspec_kw=None):
-        """
-        Builds a layout based on an grid of strings
+    def build_grid(self, layout, *, subplot_kw=None, gridspec_kw=None):
+        """Build a layout based on an grid of strings.
 
-        This is a helper function to build complex GridSpec layouts visually
+        This is a helper function to build complex GridSpec layouts visually.
 
         Parameters
         ----------
         layout : list of list of str
-            A visual layout of how you want your Axes to be arranged labeled as strings.
-            For example ::
+
+            A visual layout of how you want your Axes to be arranged
+            labeled as strings.  For example ::
 
                x = [['A', 'A', 'B'],
                     ['C', 'D', 'B']]
 
             Produces 4 axes:
 
-               - 'A' which is 1 row high and spans the first two columns
-               - 'B' which is 2 rows high and is on the right edge
-               - 'C' which in 1 row and 1 column wide in the bottom left
-               - 'D' which in 1 row and 1 column wide in the bottom center
+            - 'A' which is 1 row high and spans the first two columns
+            - 'B' which is 2 rows high and is on the right edge
+            - 'C' which in 1 row and 1 column wide in the bottom left
+            - 'D' which in 1 row and 1 column wide in the bottom center
 
         subplot_kw : dict, optional
             Dict with keywords passed to the
