From 68cad54327f0b5b38c9b9fa835a9a39f75308a32 Mon Sep 17 00:00:00 2001
From: Tim Hoffmann <2836374+timhoffm@users.noreply.github.com>
Date: Wed, 12 Mar 2025 14:20:06 +0100
Subject: [PATCH] DOC: Explain how to start the mainloop after
 show(block=False)

---
 lib/matplotlib/pyplot.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
index ab33146d2185..52adb686a3d1 100644
--- 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`).