From f0e6d0148f91d957d172f5e4f2b5a11aa3e2ab99 Mon Sep 17 00:00:00 2001 From: Phil Ruffwind Date: Fri, 11 Nov 2016 01:08:47 -0500 Subject: [PATCH] Clarify documentation of pyplot.draw See #7432. --- lib/matplotlib/pyplot.py | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py index 02180ee05cc5..b9782b7e3044 100644 --- a/lib/matplotlib/pyplot.py +++ b/lib/matplotlib/pyplot.py @@ -674,10 +674,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