Improve docstring of draw_idle()

timhoffm · timhoffm · commit 301660d5e4db · 2018-10-13T19:16:22.000+02:00
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -1893,7 +1893,16 @@ def draw(self, *args, **kwargs):
 
     def draw_idle(self, *args, **kwargs):
         """
-        :meth:`draw` only if idle; defaults to draw but backends can override
+        Trigger `.draw` if the backend is not already busy with drawing.
+
+        This function can be used instead of `.draw` to prevent unnecessary
+        multiple renderings.
+
+        Note
+        ----
+        Backends may choose to override the behavior and implement their own
+        strategy to prevent multiple renderings.
+
         """
         if not self._is_idle_drawing:
             with self._idle_draw_cntx():
