Backport PR #11831: animation api documentation changes

tacaswell · MeeseeksDev[bot] · commit 4fa7e1448273 · 2018-08-09T19:57:40.000Z
diff --git a/doc/_templates/autosummary_inher.rst b/doc/_templates/autosummary_inher.rst
@@ -0,0 +1,24 @@
+{{ fullname | escape | underline}}
+
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}
+    :inherited-members:
+    :show-inheritance:
+
+{% if objtype in ['class', 'method', 'function'] %}
+{% if objname in ['AxesGrid', 'Scalable', 'HostAxes', 'FloatingAxes',
+                      'ParasiteAxesAuxTrans', 'ParasiteAxes'] %}
+.. Filter out the above aliases to other classes, as sphinx gallery
+   creates no example file for those (sphinx-gallery/sphinx-gallery#365)
+
+{% else %}
+.. include:: {{module}}.{{objname}}.examples
+
+.. raw:: html
+
+    <div class="clearer"></div>
+
+{% endif %}
+{% endif %}
diff --git a/doc/api/animation_api.rst b/doc/api/animation_api.rst
@@ -19,6 +19,7 @@ The easiest way to make a live animation in matplotlib is to use one of the
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    FuncAnimation
@@ -160,6 +161,7 @@ all data in memory.
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    PillowWriter
@@ -170,10 +172,11 @@ on all systems.
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    FFMpegWriter
-   ImageMagickFileWriter
+   ImageMagickWriter
    AVConvWriter
 
 The file-based writers save temporary files for each frame which are stitched
@@ -182,10 +185,11 @@ debug.
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    FFMpegFileWriter
-   ImageMagickWriter
+   ImageMagickFileWriter
    AVConvFileWriter
 
 Fundamentally, a `MovieWriter` provides a way to grab sequential frames
@@ -234,6 +238,7 @@ Animation Base Classes
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    Animation
@@ -248,6 +253,7 @@ writer and the class to allow a string to be passed to
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    MovieWriterRegistry
@@ -259,6 +265,7 @@ To reduce code duplication base classes
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    AbstractMovieWriter
@@ -269,6 +276,7 @@ and mixins
 
 .. autosummary::
    :toctree: _as_gen
+   :template: autosummary_inher.rst
    :nosignatures:
 
    AVConvBase
@@ -284,6 +292,8 @@ Inheritance Diagrams
 
 .. inheritance-diagram:: matplotlib.animation.FuncAnimation matplotlib.animation.ArtistAnimation
    :private-bases:
+   :parts: 1
 
 .. inheritance-diagram:: matplotlib.animation.AVConvFileWriter matplotlib.animation.AVConvWriter matplotlib.animation.FFMpegFileWriter matplotlib.animation.FFMpegWriter matplotlib.animation.ImageMagickFileWriter matplotlib.animation.ImageMagickWriter
    :private-bases:
+   :parts: 1
