Merge pull request #20004 from meeseeksmachine/auto-backport-of-pr-19999-on-v3.4.x

QuLogic · web-flow · commit 08d9dc9e5c6f · 2021-04-17T01:56:29.000-04:00
Backport PR #19999 on branch v3.4.x (DOC: add note about axes order to docstring)
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -1740,7 +1740,9 @@ def subplot_mosaic(self, layout, *, subplot_kw=None, gridspec_kw=None,
         Returns
         -------
         dict[label, Axes]
-           A dictionary mapping the labels to the Axes objects.
+           A dictionary mapping the labels to the Axes objects.  The order of
+           the axes is left-to-right and top-to-bottom of their position in the
+           total layout.
 
         """
         subplot_kw = subplot_kw or {}
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -1511,7 +1511,9 @@ def subplot_mosaic(layout, *, subplot_kw=None, gridspec_kw=None,
        The new figure
 
     dict[label, Axes]
-       A dictionary mapping the labels to the Axes objects.
+       A dictionary mapping the labels to the Axes objects.  The order of
+       the axes is left-to-right and top-to-bottom of their position in the
+       total layout.
 
     """
     fig = figure(**fig_kw)
