DOC: add docs for _AxesBase, _ImageBase and _AnnotationBase

rcomer · rcomer · commit a2b6fa64cce3 · 2026-05-30T16:29:44.000+01:00
The inheritance diagram in the artists API docs broke without these.
diff --git a/doc/api/axes__base_api.rst b/doc/api/axes__base_api.rst
@@ -0,0 +1,12 @@
+*************************
+``matplotlib.axes._base``
+*************************
+
+.. This is a stub which is only included to make inheritance links work.  It
+   deliberately does not include any docstrings, so the class-doc-from directive
+   specifies a non-existent docstring.
+
+.. autoclass:: matplotlib.axes._base._AxesBase
+   :no-members:
+   :class-doc-from: class
+   :show-inheritance:
diff --git a/doc/api/image_api.rst b/doc/api/image_api.rst
@@ -6,3 +6,7 @@
    :members:
    :undoc-members:
    :show-inheritance:
+
+.. autoclass:: _ImageBase
+   :class-doc-from: class
+   :show-inheritance:
diff --git a/doc/api/index.rst b/doc/api/index.rst
@@ -146,6 +146,7 @@ Alphabetical list of modules:
    _type1font.rst
    _tight_bbox_api.rst
    _tight_layout_api.rst
+   axes__base_api.rst
    toolkits/mplot3d.rst
    toolkits/axes_grid1.rst
    toolkits/axisartist.rst
diff --git a/doc/api/text_api.rst b/doc/api/text_api.rst
@@ -12,6 +12,9 @@
    :undoc-members:
    :show-inheritance:
 
+.. autoclass:: matplotlib.text._AnnotationBase
+   :class-doc-from: class
+
 .. autoclass:: matplotlib.text.Annotation
    :members:
    :undoc-members:
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
@@ -1677,6 +1677,7 @@ def __call__(self, renderer):
 
 
 class _AnnotationBase:
+    """Mixin class for annotations."""
     def __init__(self,
                  xy,
                  xycoords='data',
