DOC added constrained layout to plt.figure

NelleV · NelleV · commit aaa74a502ceb · 2020-01-24T09:59:27.000+01:00
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -457,6 +457,15 @@ def figure(num=None,  # autoincrement if None, else integer from 1-N
         ``h_pad``, and ``rect``, the default `.tight_layout` paddings
         will be overridden.
 
+    constrained_layout : bool, default: :rc:`figure.constrained_layout.use`
+        If ``True`` use constrained layout to adjust positioning of plot
+        elements.  Like ``tight_layout``, but designed to be more
+        flexible.  See
+        :doc:`/tutorials/intermediate/constrainedlayout_guide`
+        for examples.  (Note: does not work with `add_subplot` or
+        `~.pyplot.subplot2grid`.)
+
+
     **kwargs : optional
         See `~.matplotlib.figure.Figure` for other possible arguments.
 
