Merge pull request #7449 from Rufflewind/master

tacaswell · tacaswell · commit 5ee1eeecda3f · 2016-11-14T23:38:51.000-05:00
DOC: Clarify documentation of pyplot.draw
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -675,10 +675,11 @@ def clf():
 def draw():
     """Redraw the current figure.
 
-    This is used in interactive mode to update a figure that has been
-    altered, but not automatically re-drawn.  This should be only rarely
-    needed, but there may be ways to modify the state of a figure with
-    out marking it as `stale`.  Please report these cases as bugs.
+    This is used to update a figure that has been altered, but not
+    automatically re-drawn.  If interactive mode is on (:func:`.ion()`), this
+    should be only rarely needed, but there may be ways to modify the state of
+    a figure without marking it as `stale`.  Please report these cases as
+    bugs.
 
     A more object-oriented alternative, given any
     :class:`~matplotlib.figure.Figure` instance, :attr:`fig`, that
