Fix links

jklymak · jklymak · commit 4abe96a99c7c · 2023-07-11T22:23:20.000-07:00
diff --git a/galleries/users_explain/artists/artist_intro.rst b/galleries/users_explain/artists/artist_intro.rst
@@ -5,9 +5,8 @@ Introduction to Artists
 
 Almost all objects you interact with on a Matplotlib plot are called "Artist"
 (and are subclasses of the `.Artist` class).  :doc:`Figure <../figure/index>`
-and :doc:`Axes <../axes/index>` are Artists, and generally contain :doc:`Axis
-<../axis/index>` Artists and Artists that contain data or annotation
-information.
+and :doc:`Axes <../axes/index>` are Artists, and generally contain
+`~.axis.Axis` Artists and Artists that contain data or annotation information.
 
 
 Creating Artists
diff --git a/galleries/users_explain/artists/index.rst b/galleries/users_explain/artists/index.rst
@@ -4,9 +4,8 @@ Artists
 
 Almost all objects you interact with on a Matplotlib plot are called "Artist"
 (and are subclasses of the `.Artist` class).  :doc:`Figure <../figure/index>`
-and :doc:`Axes <../axes/index>` are Artists, and generally contain :doc:`Axis
-<../axis/index>` Artists and Artists that contain data or annotation
-information.
+and :doc:`Axes <../axes/index>` are Artists, and generally contain
+`~.axis.Axis` Artists and Artists that contain data or annotation information.
 
 .. toctree::
     :maxdepth: 2
diff --git a/galleries/users_explain/axes/axes_intro.rst b/galleries/users_explain/axes/axes_intro.rst
@@ -5,7 +5,7 @@ Introduction to Axes (or Subplots)
 
 Matplotlib `~.axes.Axes` are the gateway to creating your data visualizations.
 Once an Axes is placed on a figure there are many methods that can be used to
-add data to the Axes. An Axes typically has a pair of :doc:`Axis <../axis/index>`
+add data to the Axes. An Axes typically has a pair of `~.axis.Axis`
 Artists that define the data coordinate system, and include methods to add
 annotations like x- and y-labels, titles, and legends.
 
@@ -130,7 +130,7 @@ Note that text can also be added to axes using `~.axes.Axes.text`, and `~.axes.A
 Axes limits, scales, and ticking
 --------------------------------
 
-Each Axes has two (or more) `~.axis.Axis` objects, that can be accessed via :attr:`~matplotlib.axes.Axes.xaxis` and :attr:`~matplotlib.axes.Axes.yaxis` properties.  These have substantial number of methods on them, and for highly customizable Axis-es it is useful to read more about that API (:doc:`../axis/index`).   However, the Axes class offers a number of helpers for the most common of these methods.  Indeed, the `~.axes.Axes.set_xlabel`, discussed above, is a helper for the `~.Axis.set_label_text`.
+Each Axes has two (or more) `~.axis.Axis` objects, that can be accessed via :attr:`~matplotlib.axes.Axes.xaxis` and :attr:`~matplotlib.axes.Axes.yaxis` properties.  These have substantial number of methods on them, and for highly customizable Axis-es it is useful to read the API at `~.axis.Axis`.   However, the Axes class offers a number of helpers for the most common of these methods.  Indeed, the `~.axes.Axes.set_xlabel`, discussed above, is a helper for the `~.Axis.set_label_text`.
 
 Other important methods set the extent on the axes (`~.axes.Axes.set_xlim`, `~.axes.Axes.set_ylim`), or more fundamentally the scale of the axes.  So for instance, we can make an Axis have a logarithmic scale, and zoom in on a sub-portion of the data:
 
@@ -158,7 +158,7 @@ Many aspects of Axes ticks and tick labeling can be adjusted using `~.axes.Axes.
                    labelcolor='green')
 
 
-More fine-grained control on ticks, setting scales, and controlling the Axis can be highly customized beyond these Axes-level helpers.  An introduction to these methods can be found in :ref:`users_axis`, or the API reference for `.axis.Axis`.
+More fine-grained control on ticks, setting scales, and controlling the Axis can be highly customized beyond these Axes-level helpers.
 
 Axes layout
 -----------
diff --git a/galleries/users_explain/axes/axes_scales.py b/galleries/users_explain/axes/axes_scales.py
@@ -89,7 +89,7 @@
 # =====================
 #
 # There are other scales that can be used.  The list of registered
-# scales can be returned from `.scales.get_scale_names`:
+# scales can be returned from `.scale.get_scale_names`:
 
 print(mscale.get_scale_names())
 
@@ -122,7 +122,7 @@
 #
 # Some of the default scales have optional arguments.  These are
 # documented in the API reference for the respective scales at
-# `~.matplotlib.scales`.  One can change the base of the logarithm
+# `~.matplotlib.scale`.  One can change the base of the logarithm
 # being plotted (eg 2 below) or the linear threshold range
 # for ``'symlog'``.
 
@@ -183,9 +183,9 @@ def inverse(a):
 # ==================
 #
 # A scale is an object that gets attached to an axis.  The class documentation
-# is at `~.scale`. `~.axes.Axes.set_xscale` and `~.axes.Axes.set_yscale` are
-# helper methods for `~.axis.Axis.set_scale`.  You can also determine the scale
-# on an axis with:
+# is at `~matplotlib.scale`. `~.axes.Axes.set_xscale` and `~.axes.Axes.set_yscale`
+# set the scale on the respective Axis objects.  You can determine the scale
+# on an axis with `~.axis.Axis.get_scale`:
 
 fig, ax = plt.subplots(layout='constrained',
                               figsize=(3.2, 3))
@@ -198,7 +198,7 @@ def inverse(a):
 #
 # Setting a scale does three things.  First it defines a transform on the axis
 # that maps between data values to position along the axis.  This transform can
-# be accessed via `~.axis.Axis.get_transform`.
+# be accessed via ``get_transform``:
 
 print(ax.yaxis.get_transform())
 
diff --git a/galleries/users_explain/axes/axes_ticks.py b/galleries/users_explain/axes/axes_ticks.py
@@ -231,7 +231,7 @@ def fmt_two_digits(x, pos):
 # ===============================
 #
 # The appearance of ticks can be controlled at a low level by finding the
-# individual `~.ticker.Ticks` on the axis.  However, usually it is simplest to
+# individual `~.axis.Tick` on the axis.  However, usually it is simplest to
 # use `~.axes.Axes.tick_params` to change all the objects at once.
 #
 # The ``tick_params`` method can change the properties of ticks:
diff --git a/galleries/users_explain/axes/index.rst b/galleries/users_explain/axes/index.rst
@@ -4,7 +4,7 @@ Axes and subplots
 
 Matplotlib `~.axes.Axes` are the gateway to creating your data visualizations.
 Once an Axes is placed on a figure there are many methods that can be used to
-add data to the Axes. An Axes typically has a pair of :doc:`Axis <../axis/index>`
+add data to the Axes. An Axes typically has a pair of `~.axis.Axis`
 Artists that define the data coordinate system, and include methods to add
 annotations like x- and y-labels, titles, and legends.
 
@@ -41,8 +41,8 @@ annotations like x- and y-labels, titles, and legends.
     :maxdepth: 2
     :includehidden:
 
-    scales
-    ticks
+    axes_scales
+    axes_ticks
     Legends <legend_guide>
     Subplot mosaic <mosaic>
 
diff --git a/lib/matplotlib/axis.py b/lib/matplotlib/axis.py
@@ -774,6 +774,7 @@ def set_label_coords(self, x, y, transform=None):
         self.stale = True
 
     def get_transform(self):
+        """Return the transform used in the Axis' scale"""
         return self._scale.get_transform()
 
     def get_scale(self):

Original file line number	Diff line number	Diff line change
`@@ -231,7 +231,7 @@ def fmt_two_digits(x, pos):`
`231`	`231`	`# ===============================`
`232`	`232`	`#`
`233`	`233`	`# The appearance of ticks can be controlled at a low level by finding the`
`234`		-# individual `~.ticker.Ticks` on the axis. However, usually it is simplest to
	`234`	+# individual `~.axis.Tick` on the axis. However, usually it is simplest to
`235`	`235`	# use `~.axes.Axes.tick_params` to change all the objects at once.
`236`	`236`	`#`
`237`	`237`	# The ``tick_params`` method can change the properties of ticks: