DOC/STY: improve wording and line wrapping

Co-authored-by: Elliott Sales de Andrade <[email protected]>

Author: tacaswell

doc/users/next_whats_new/per_subplot_mosaic.rst

@@ -1,7 +1,7 @@
 Per-subplot keyword arguments  in ``subplot_mosaic``
 ----------------------------------------------------
 
-It is now possible to pass keyword arguments through to the creation to each
+It is now possible to pass keyword arguments through to Axes creation in each
 specific call to ``add_subplot`` in `.Figure.subplot_mosaic` and
 `.pyplot.subplot_mosaic` :
 

lib/matplotlib/figure.py

@@ -1790,8 +1790,8 @@ def _normalize_grid_string(layout):
 
     def subplot_mosaic(self, mosaic, *, sharex=False, sharey=False,
                        width_ratios=None, height_ratios=None,
-                       empty_sentinel='.', subplot_kw=None, gridspec_kw=None,
-                       per_subplot_kw=None):
+                       empty_sentinel='.',
+                       subplot_kw=None, per_subplot_kw=None, gridspec_kw=None):
         """
         Build a layout of Axes based on ASCII art or nested lists.
 
@@ -1925,9 +1925,7 @@ def subplot_mosaic(self, mosaic, *, sharex=False, sharey=False,
                 tuple(k): v for k, v in per_subplot_kw.items()
             }
 
-        per_subplot_kw = self._norm_per_subplot_kw(
-            per_subplot_kw
-        )
+        per_subplot_kw = self._norm_per_subplot_kw(per_subplot_kw)
 
         # Only accept strict bools to allow a possible future API expansion.
         _api.check_isinstance(bool, sharex=sharex, sharey=sharey)

tutorials/provisional/mosaic.py

@@ -295,7 +295,6 @@ def identify_axes(ax_dict, fontsize=48):
 # Per-Axes subplot keyword arguments
 # ----------------------------------
 #
-#
 # If you need to control the parameters passed to each subplot individually use
 # *per_subplot_kw* to pass a mapping between the Axes identifiers (or
 # tuples of Axes identifiers) to dictionaries of keywords to be passed.
@@ -330,7 +329,7 @@ def identify_axes(ax_dict, fontsize=48):
 identify_axes(axd)
 
 ###############################################################################
-# if *subplot_kw* and *per_subplot_kw* are used together, then they are
+# If *subplot_kw* and *per_subplot_kw* are used together, then they are
 # merged with *per_subplot_kw* taking priority: