add layout='none' option to Figure constructor [skip appveyor] [skip github] [skip azp]

rcomer · rcomer · commit 531735e2d709 · 2023-02-23T17:13:33.000Z
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -2420,7 +2420,8 @@ def __init__(self,
                 The use of this parameter is discouraged. Please use
                 ``layout='constrained'`` instead.
 
-        layout : {'constrained', 'compressed', 'tight', `.LayoutEngine`, None}
+        layout : {'constrained', 'compressed', 'tight', 'none', `.LayoutEngine`, \
+None}, default: None
             The layout mechanism for positioning of plot elements to avoid
             overlapping Axes decorations (labels, ticks, etc). Note that
             layout managers can have significant performance penalties.
@@ -2442,6 +2443,8 @@ def __init__(self,
               decorations do not overlap. See `.Figure.set_tight_layout` for
               further details.
 
+            - 'none': Do not use a layout engine.
+
             - A `.LayoutEngine` instance. Builtin layout classes are
               `.ConstrainedLayoutEngine` and `.TightLayoutEngine`, more easily
               accessible by 'constrained' and 'tight'.  Passing an instance
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -740,8 +740,8 @@ def figure(num=None,  # autoincrement if None, else integer from 1-N
     clear : bool, default: False
         If True and the figure already exists, then it is cleared.
 
-    layout : {'constrained', 'tight', 'compressed', \
-        `.LayoutEngine`, None}, default: None
+    layout : {'constrained', 'compressed', 'tight', 'none', `.LayoutEngine`, None}, \
+default: None
         The layout mechanism for positioning of plot elements to avoid
         overlapping Axes decorations (labels, ticks, etc). Note that layout
         managers can measurably slow down figure display. Defaults to *None*
