Clarify docstring of [un]install_repl_displayhook()

timhoffm · timhoffm · commit dc0ca6050a87 · 2022-04-26T23:05:02.000+02:00
Still not clear to me: Does this have to be a public function? When
would a user call it explicitly?
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -114,8 +114,11 @@ def _copy_docstring_and_deprecators(method, func=None):
 
 def install_repl_displayhook():
     """
-    Install a repl display hook so that any stale figure are automatically
-    redrawn when control is returned to the repl.
+    Connect to the display hook of the current shell.
+
+    The display hook gets called when the read-evaluate-print-loop (REPL) of
+    the shell has finished the execution of a command. We use this callback
+    to be able to automatically update a figure in interactive mode.
 
     This works both with IPython and with vanilla python shells.
     """
@@ -153,7 +156,7 @@ def post_execute():
 
 def uninstall_repl_displayhook():
     """
-    Uninstall the Matplotlib display hook.
+    Disconnect from the display hook of the current shell.
 
     .. warning::
 
