Merge pull request #29591 from meeseeksmachine/auto-backport-of-pr-29585-on-v3.10.x

rcomer · web-flow · commit 1401d735d023 · 2025-02-07T21:20:11.000Z
Backport PR #29585 on branch v3.10.x (DOC: Document that tight_layout may not converge)
diff --git a/galleries/users_explain/axes/tight_layout_guide.py b/galleries/users_explain/axes/tight_layout_guide.py
@@ -165,6 +165,10 @@ def example_plot(ax, fontsize=12):
 #   a limitation of the current algorithm, and it is not clear why it
 #   happens. Meanwhile, use of pad larger than 0.3 is recommended.
 #
+# * The algorithm of ``tight_layout`` does not necessarily converge,
+#   i.e. calling ``tight_layout`` multiple times can lead to slight
+#   variations in the layout between the calls.
+#
 # Use with GridSpec
 # =================
 #

Original file line number	Diff line number	Diff line change
`@@ -165,6 +165,10 @@ def example_plot(ax, fontsize=12):`
`165`< 7852 /td>	`165`	`# a limitation of the current algorithm, and it is not clear why it`
`166`	`166`	`# happens. Meanwhile, use of pad larger than 0.3 is recommended.`
`167`	`167`	`#`
	`168`	+# * The algorithm of ``tight_layout`` does not necessarily converge,
	`169`	+# i.e. calling ``tight_layout`` multiple times can lead to slight
	`170`	`+# variations in the layout between the calls.`
	`171`	`+#`
`168`	`172`	`# Use with GridSpec`
`169`	`173`	`# =================`
`170`	`174`	`#`