DOC: improve spines crosslinking [skip-actions] [skip-azure] [skip-appveyor]

jklymak · jklymak · commit daa24b0b9494 · 2022-06-25T16:30:52.000+02:00
diff --git a/examples/spines/spines.py b/examples/spines/spines.py
@@ -8,6 +8,9 @@
 - normal Axes, with spines on all four sides;
 - an Axes with spines only on the left and bottom;
 - an Axes using custom bounds to limit the extent of the spine.
+
+Each `.axes.Axes` has a list of `.Spine` objects, accessible
+via the container ``ax.spines``.
 """
 import numpy as np
 import matplotlib.pyplot as plt
@@ -44,3 +47,12 @@
 ax2.xaxis.set_ticks_position('bottom')
 
 plt.show()
+
+# .. admonition:: References
+#
+#    The use of the following functions, methods, classes and modules is shown
+#    in this example:
+#
+#    - `matplotlib.Spines.set_visible`
+#    - `matplotlib.Spines.set_bounds`
+#    - `matplotlib.axis.set_ticks_position`
diff --git a/lib/matplotlib/spines.py b/lib/matplotlib/spines.py
@@ -27,6 +27,7 @@ class Spine(mpatches.Patch):
     `~.Spine.set_patch_line`, `~.Spine.set_patch_circle`, or
     `~.Spine.set_patch_arc` has been called. Line-like is the default.
 
+    For examples see :ref:`spines_examples`.
     """
     def __str__(self):
         return "Spine"
