DOC: Explain how to start the mainloop after show(block=False)

timhoffm · timhoffm · commit 68cad54327f0 · 2025-03-12T14:20:06.000+01:00
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -583,7 +583,10 @@ def show(*args, **kwargs) -> None:
 
         If `False` ensure that all figure windows are displayed and return
         immediately.  In this case, you are responsible for ensuring
-        that the event loop is running to have responsive figures.
+        that the event loop is running to have responsive figures; in the
+        simplest form by calling ``fig.canvas.manager.mainloop()`` which is
+        what a blocking show is doing internally. Note that the GUI mainloop
+        itself is blocking.
 
         Defaults to True in non-interactive mode and to False in interactive
         mode (see `.pyplot.isinteractive`).
