MNT: add warnings to Figure.show

tacaswell · tacaswell · commit 62632846ec85 · 2020-05-01T00:55:09.000-04:00
diff --git a/lib/matplotlib/figure.py b/lib/matplotlib/figure.py
@@ -395,6 +395,11 @@ def show(self, warn=True):
             python script, you should use `matplotlib.pyplot.show` instead,
             which takes care of managing the event loop for you.
 
+        .. warning
+
+           If the GUI event loop is not running the figure will be shown,
+           but will not be responsive and may not draw.
+
         Parameters
         ----------
         warn : bool, default: True
