DOC: Improve writer parameter docs of Animation.save()

timhoffm · timhoffm · commit 56b92762d9cf · 2025-12-30T03:16:31.000+01:00
Closes matplotlib#24159.
diff --git a/lib/matplotlib/animation.py b/lib/matplotlib/animation.py
@@ -955,9 +955,20 @@ def save(self, filename, writer=None, fps=None, dpi=None, codec=None,
         filename : str
             The output filename, e.g., :file:`mymovie.mp4`.
 
-        writer : `MovieWriter` or str, default: :rc:`animation.writer`
-            A `MovieWriter` instance to use or a key that identifies a
-            class to use, such as 'ffmpeg'.
+        writer : `AbstractMovieWriter` subclass or str, default: :rc:`animation.writer`
+            The writer to use. This can be an instance of an `AbstractMovieWriter`
+            subclass or a string. The builtin writers are
+
+            ==================  ==============================
+            str                 class
+            ==================  ==============================
+            'ffmpeg'            `.FFMpegWriter`
+            'ffmpeg_file'       `.FFMpegFileWriter`
+            'imagemagick'       `.ImageMagickWriter`
+            'imagemagick_file'  `.ImageMagickFileWriter`
+            'pillow'            `.PillowWriter`
+            'html'              `.HTMLWriter`
+            ==================  ==============================
 
         fps : int, optional
             Movie frame rate (per second).  If not set, the frame rate from the
