DOC: Define the effect of rcParams["figure.raise_window"] = False

timhoffm · timhoffm · commit ed7664a7d433 · 2025-12-08T10:50:44.000+01:00
Closes #20415.
diff --git a/lib/matplotlib/mpl-data/matplotlibrc b/lib/matplotlib/mpl-data/matplotlibrc
@@ -600,6 +600,9 @@
                                # the pyplot interface before emitting a warning.
                                # If less than one this feature is disabled.
 #figure.raise_window : True    # Raise the GUI window to front when show() is called.
+                               # If set to False, we currently do not take any further
+                               # actions and whether the window appears on the front
+                               # may depend on the GUI framework and window manager.
 
 ## The figure subplot parameters.  All dimensions are a fraction of the figure width and height.
 #figure.subplot.left:   0.125  # the left side of the subplots of the figure
