diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
index 6c18ba1a643e..7bb7c542ee77 100644
--- a/lib/matplotlib/figure.py
+++ b/lib/matplotlib/figure.py
@@ -2614,18 +2614,25 @@ def show(self, warn=True):
may only be shown briefly or not shown at all if you or your
environment are not managing an event loop.
- Proper use cases for `.Figure.show` include running this from a
- GUI application or an IPython shell.
-
- If you're running a pure python shell or executing a non-GUI
- python script, you should use `matplotlib.pyplot.show` instead,
- which takes care of managing the event loop for you.
+ Use cases for `.Figure.show` include running this from a GUI
+ application (where there is persistently an event loop running) or
+ from a shell, like IPython, that install an input hook to allow the
+ interactive shell to accept input while the figure is also being
+ shown and interactive. Some, but not all, GUI toolkits will
+ register an input hook on import. See :ref:`cp_integration` for
+ more details.
+
+ If you're in a shell without input hook integration or executing a
+ python script, you should use `matplotlib.pyplot.show` with
+ ``block=True`` instead, which takes care of starting and running
+ the event loop for you.
Parameters
----------
warn : bool, default: True
If ``True`` and we are not running headless (i.e. on Linux with an
unset DISPLAY), issue warning when called on a non-GUI backend.
+
"""
if self.canvas.manager is None:
raise AttributeError(
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy