matplotlib · rcomer · Feb 7, 2025 · Feb 7, 2025
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
 # =================
 #