DOC:

jklymak · jklymak · commit 118aa9fa9f66 · 2022-03-24T11:25:09.000+01:00
diff --git a/lib/matplotlib/layout_engine.py b/lib/matplotlib/layout_engine.py
@@ -196,6 +196,10 @@ def __init__(self, *, h_pad=None, w_pad=None,
             If h/wspace < h/w_pad, then the pads are used instead.
             Default to :rc:`figure.constrained_layout.hspace` and
             :rc:`figure.constrained_layout.wspace`.
+        compress : bool
+            Whether to use compressed layout or not; useful for fixed-aspect
+            simple grids of axes (e.g. a grid of images).  See
+            `_compressed_layout`.
         """
         super().__init__(**kwargs)
         # set the defaults:
@@ -205,7 +209,6 @@ def __init__(self, *, h_pad=None, w_pad=None,
                  hspace=mpl.rcParams['figure.constrained_layout.hspace'])
         # set anything that was passed in (None will be ignored):
         self.set(w_pad=w_pad, h_pad=h_pad, wspace=wspace, hspace=hspace)
-        # see CompressedLayoutEngine below...
         self._compress = compress
 
     def execute(self, fig):
diff --git a/tutorials/intermediate/constrainedlayout_guide.py b/tutorials/intermediate/constrainedlayout_guide.py
@@ -451,9 +451,12 @@ def example_plot(ax, fontsize=12, hide_labels=False):
 axs[1].set_position([0.2, 0.2, 0.4, 0.4])
 
 ###############################################################################
+# .. _compressed_layout:
+#
 # Grids of fixed aspect-ratio Axes: "compressed" layout
 # =====================================================
 #
+#
 # By default, ``constrained_layout`` acts on the total size of an axes, but
 # when Axes have fixed aspect ratios, one side is made shorter.  For a grid
 # of such Axes, this leaves a large gap in the shortened direction. For
