Document that TimedAnimation should not be used

QuLogic · QuLogic · commit c6e105fff76b · 2026-04-18T01:45:53.000-04:00
This copies the text from `Animation`, but also puts both in a warning box. Fixes #30831
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
@@ -855,8 +855,10 @@ class Animation:
     """
     A base class for Animations.
 
-    This class is not usable as is, and should be subclassed to provide needed
-    behavior.
+    .. warning::
+
+        This class is not usable as is, and should be subclassed to provide needed
+        behavior.
 
     .. note::
 
@@ -1425,6 +1427,11 @@ class TimedAnimation(Animation):
 
     A new frame is drawn every *interval* milliseconds.
 
+    .. warning::
+
+        This class is not usable as is, and should be subclassed to provide needed
+        behavior.
+
     .. note::
 
         You must store the created Animation in a variable that lives as long
