DOC: Fix non-working code object references

timhoffm · timhoffm · commit cb55075cd27d · 2024-09-17T09:03:10.000+02:00
These were not rendered as links in the current docs, because the associated code objects do not exist as targets in the docs. For some reason, sphinx did not complain about it. But it does in some recent PRs (extracted from #28560) - I'm unclear why, but anyway the correct solution is to change to explicitly listing the attributes.
diff --git a/doc/api/axes_api.rst b/doc/api/axes_api.rst
@@ -28,6 +28,17 @@ The Axes class
 
    Axes
 
+Attributes
+----------
+
+.. autosummary::
+   :toctree: _as_gen
+   :template: autosummary.rst
+   :nosignatures:
+
+   Axes.viewLim
+   Axes.dataLim
+
 Plotting
 ========
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -85,13 +85,6 @@ class Axes(_AxesBase):
         methods instead; e.g. from `.pyplot` or `.Figure`:
         `~.pyplot.subplots`, `~.pyplot.subplot_mosaic` or `.Figure.add_axes`.
 
-    Attributes
-    ----------
-    dataLim : `.Bbox`
-        The bounding box enclosing all data displayed in the Axes.
-    viewLim : `.Bbox`
-        The view limits in data coordinates.
-
     """
     ### Labelling, legend and texts
 
diff --git a/lib/matplotlib/axes/_base.py b/lib/matplotlib/axes/_base.py
@@ -551,6 +551,9 @@ class _AxesBase(martist.Artist):
 
     _subclass_uses_cla = False
 
+    dataLim: mtransforms.Bbox
+    """The bounding `.Bbox` enclosing all data displayed in the Axes."""
+
     @property
     def _axis_map(self):
         """A mapping of axis names, e.g. 'x', to `Axis` instances."""
@@ -849,6 +852,7 @@ def _unstale_viewLim(self):
 
     @property
     def viewLim(self):
+        """The view limits as `.Bbox` in data coordinates."""
         self._unstale_viewLim()
         return self._viewLim
 
@@ -2265,7 +2269,7 @@ def add_artist(self, a):
 
     def add_child_axes(self, ax):
         """
-        Add an `.AxesBase` to the Axes' children; return the child Axes.
+        Add an `.Axes` to the Axes' children; return the child Axes.
 
         This is the lowlevel version.  See `.axes.Axes.inset_axes`.
         """
