From f4b5faaea9c06afd1e9e749336896a900d3b4672 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Sun, 18 Dec 2022 17:43:13 +0100
Subject: [PATCH] Backport PR #24764: DOC: `subplot_mosaic` tutorial - clarify
 ratios keywords used directly

---
 tutorials/provisional/mosaic.py | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/tutorials/provisional/mosaic.py b/tutorials/provisional/mosaic.py
index 202ada6eb332..64a8cb267008 100644
--- a/tutorials/provisional/mosaic.py
+++ b/tutorials/provisional/mosaic.py
@@ -210,7 +210,9 @@ def identify_axes(ax_dict, fontsize=48):
 # (the same as `.Figure.subplots`).
 #
 # In this case we want to use the input to specify the arrangement,
-# but set the relative widths of the rows / columns via *gridspec_kw*.
+# but set the relative widths of the rows / columns.  For convenience,
+# `.gridspec.GridSpec`'s *height_ratios* and *width_ratios* are exposed in the
+# `.Figure.subplot_mosaic` calling sequence.
 
 
 axd = plt.figure(constrained_layout=True).subplot_mosaic(
@@ -227,9 +229,10 @@ def identify_axes(ax_dict, fontsize=48):
 identify_axes(axd)
 
 ###############################################################################
-# Or use the {*left*, *right*, *bottom*, *top*} keyword arguments to
+# Other `.gridspec.GridSpec` keywords can be passed via *gridspec_kw*.  For
+# example, use the {*left*, *right*, *bottom*, *top*} keyword arguments to
 # position the overall mosaic to put multiple versions of the same
-# mosaic in a figure
+# mosaic in a figure.
 
 mosaic = """AA
             BC"""