Merge pull request #18818 from anntzer/discocid

tacaswell · web-flow · commit 868504e3ffde · 2020-10-26T16:24:22.000-04:00
DOC: Clarify behavior of CallbackRegistry.disconnect with nonexistent cids.
diff --git a/lib/matplotlib/cbook/__init__.py b/lib/matplotlib/cbook/__init__.py
@@ -199,7 +199,11 @@ def _remove_proxy(self, proxy, *, _is_finalizing=sys.is_finalizing):
                 del self._func_cid_map[signal]
 
     def disconnect(self, cid):
-        """Disconnect the callback registered with callback id *cid*."""
+        """
+        Disconnect the callback registered with callback id *cid*.
+
+        No error is raised if such a callback does not exist.
+        """
         for eventname, callbackd in list(self.callbacks.items()):
             try:
                 del callbackd[cid]
