Merge pull request #26894 from anntzer/ti

QuLogic · web-flow · commit c65ce4615cb3 · 2023-10-05T18:39:30.000-04:00
Deprecate setting the timer interval while starting it.
diff --git a/doc/api/next_api_changes/deprecations/26894-AL.rst b/doc/api/next_api_changes/deprecations/26894-AL.rst
@@ -0,0 +1,6 @@
+*interval* parameter of ``TimerBase.start``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Setting the timer *interval* while starting it is deprecated.  The interval can
+be specified instead in the timer constructor, or by setting the
+``timer.interval`` attribute.
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -1117,6 +1117,7 @@ def __del__(self):
         """Need to stop timer and possibly disconnect timer."""
         self._timer_stop()
 
+    @_api.delete_parameter("3.9", "interval", alternative="timer.interval")
     def start(self, interval=None):
         """
         Start the timer object.
