matplotlib
diff --git a/‎doc/api/next_api_changes/behavior/17494-JMK.rst
Copy file name to clipboard
+25Lines changed: 25 additions & 0 deletions b/‎doc/api/next_api_changes/behavior/17494-JMK.rst
Copy file name to clipboard
+25Lines changed: 25 additions & 0 deletions
diff --git a/‎lib/matplotlib/_constrained_layout.py
Copy file name to clipboardExpand all lines: lib/matplotlib/_constrained_layout.py
+507-563Lines changed: 507 additions & 563 deletions b/‎lib/matplotlib/_constrained_layout.py
Copy file name to clipboardExpand all lines: lib/matplotlib/_constrained_layout.py
+507-563Lines changed: 507 additions & 563 deletions
@@ -0,0 +1,25 @@
+Constrained layout rewrite
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The layout manager ``constrained_layout`` was re-written with different
+outer constraints that should be more robust to complicated subplot layouts.
+User-facing changes are:
+
+- some poorly constrained layouts will have different width/height plots than
+  before.
+- colorbars now respect the ``anchor`` keyword argument of
+  `matplotlib.colorbar.make_axes`
+- colorbars are wider.
+- colorbars in different rows or columns line up more robustly.
+- *hspace* and *wspace* options to  `.Figure.set_constrained_layout_pads`
+  were twice as wide as the docs said they should be.  So these now follow
+  the docs.
+
+This feature will remain "experimental" until the new changes have been
+used enough by users, so we anticipate version 3.5 or 3.6. On the other hand,
+``constrained_layout`` is extensively tested and used in examples in the
+library, so using it should be safe, but layouts may not be exactly the same
+as more development takes place.
+
+Details of using ``constrained_layout``, and its algorithm are available at
+:doc:`/tutorials/intermediate/constrainedlayout_guide`