MNT: switch to using class level type annotations to doc target

tacaswell · tacaswell · commit a07ca82fb0c6 · 2025-05-16T17:40:53.000-04:00
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -7,6 +7,7 @@
 from operator import attrgetter
 import re
 import textwrap
+from typing import Callable
 import types
 
 import numpy as np
@@ -594,20 +595,23 @@ class _AxesBase(martist.Artist):
     - :doc:`Axis API </api/axis_api>`
     """
 
-    #: Callable to format the x-data in an interactive window.
-    #:
-    #: The expected signature is ::
-    #:
-    #:     def fmt(val: float, /) -> str: ...
-    fmt_xdata = None
+    fmt_xdata: Callable[[float], str] | None
+    """
+    Callable to format the x-data in an interactive window.
+
+    The expected signature is ::
 
-    #: Callable to format the y-data in an interactive window.
-    #:
-    #: The expected signature is ::
-    #:
-    #:     def fmt(val: float, /) -> str: ...
-    fmt_ydata = None
+        def fmt(val: float, /) -> str: ...
+    """
 
+    fmt_ydata: Callable[[float], str] | None
+    """
+    Callable to format the y-data in an interactive window.
+
+    The expected signature is ::
+
+        def fmt(val: float, /) -> str: ...
+    """
     def __str__(self):
         return "{0}({1[0]:g},{1[1]:g};{1[2]:g}x{1[3]:g})".format(
             type(self).__name__, self._position.bounds)
diff --git a/lib/mpl_toolkits/mplot3d/axes3d.py b/lib/mpl_toolkits/mplot3d/axes3d.py
@@ -14,6 +14,7 @@
 import itertools
 import math
 import textwrap
+from typing import Callable
 import warnings
 
 import numpy as np
@@ -57,12 +58,14 @@ class Axes3D(Axes):
     Axes._shared_axes["z"] = cbook.Grouper()
     Axes._shared_axes["view"] = cbook.Grouper()
 
-    #: Callable to format the z-data in an interactive window.
-    #:
-    #: The expected signature is ::
-    #:
-    #:     def fmt(val: float, /) -> str: ...
-    fmt_zdata = None
+    fmt_zdata: Callable[[float], str] | None
+    """
+    Callable to format the z-data in an interactive window.
+
+    The expected signature is ::
+
+        def fmt(val: float, /) -> str: ...
+    """
 
     def __init__(
         self, fig, rect=None, *args,
