DOC: Fix some broken references

Author: QuLogic

doc/missing-references.json

@@ -337,9 +337,6 @@
     "Artist.stale_callback": [
       "doc/users/explain/figure/interactive_guide.rst:323"
     ],
-    "Artist.sticky_edges": [
-      "doc/api/axes_api.rst:356:<autosummary>:1"
-    ],
     "Axes.dataLim": [
       "doc/api/axes_api.rst:293:<autosummary>:1",
       "lib/matplotlib/axes/_base.py:docstring of matplotlib.axes._base._AxesBase.update_datalim:2"
@@ -357,9 +354,6 @@
     "Image": [
       "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.gci:4"
     ],
-    "ImageComparisonFailure": [
-      "lib/matplotlib/testing/decorators.py:docstring of matplotlib.testing.decorators.image_comparison:2"
-    ],
     "Line2D.pick": [
       "doc/users/explain/figure/event_handling.rst:568"
     ],
@@ -665,29 +659,17 @@
     "mpl_toolkits.axislines.Axes": [
       "lib/mpl_toolkits/axisartist/axis_artist.py:docstring of mpl_toolkits.axisartist.axis_artist:7"
     ],
-    "next_whats_new": [
-      "doc/users/next_whats_new/README.rst:6"
-    ],
     "option_scale_image": [
       "lib/matplotlib/backends/backend_cairo.py:docstring of matplotlib.backends.backend_cairo.RendererCairo.draw_image:22",
       "lib/matplotlib/backends/backend_pdf.py:docstring of matplotlib.backends.backend_pdf.RendererPdf.draw_image:22",
       "lib/matplotlib/backends/backend_ps.py:docstring of matplotlib.backends.backend_ps.RendererPS.draw_image:22",
       "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template.RendererTemplate.draw_image:22"
     ],
-    "print_xyz": [
-      "lib/matplotlib/backends/backend_template.py:docstring of matplotlib.backends.backend_template:22"
-    ],
     "toggled": [
       "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.disable:4",
       "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.enable:4",
       "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.AxisScaleBase.trigger:2",
       "lib/matplotlib/backend_tools.py:docstring of matplotlib.backend_tools.ZoomPanBase.trigger:2"
-    ],
-    "tool_removed_event": [
-      "lib/matplotlib/backend_bases.py:docstring of matplotlib.backend_bases.ToolContainerBase.remove_toolitem:6"
-    ],
-    "whats_new.rst": [
-      "doc/users/next_whats_new/README.rst:6"
     ]
   }
 }

doc/users/next_whats_new/README.rst

@@ -3,7 +3,8 @@
 Instructions for writing "What's new" entries
 =============================================
 
-Please place new portions of `whats_new.rst` in the `next_whats_new` directory.
+Please place new portions of :file:`whats_new.rst` in the :file:`next_whats_new`
+directory.
 
 When adding an entry please look at the currently existing files to
 see if you can extend any of them.  If you create a file, name it

lib/matplotlib/axes/_base.py

@@ -2635,7 +2635,7 @@ def set_autoscale_on(self, b):
     @property
     def use_sticky_edges(self):
         """
-        When autoscaling, whether to obey all `Artist.sticky_edges`.
+        When autoscaling, whether to obey all `.Artist.sticky_edges`.
 
         Default is ``True``.
 

lib/matplotlib/backend_bases.py

@@ -3419,7 +3419,7 @@ def remove_toolitem(self, name):
 
         This hook must be implemented in each backend and contains the
         backend-specific code to remove an element from the toolbar; it is
-        called when `.ToolManager` emits a `tool_removed_event`.
+        called when `.ToolManager` emits a ``tool_removed_event``.
 
         Because some tools are present only on the `.ToolManager` but not on
         the `ToolContainer`, this method must be a no-op when called on a tool

lib/matplotlib/backends/backend_template.py

@@ -20,8 +20,8 @@
     import matplotlib
     matplotlib.use("module://my.backend")
 
-If your backend implements support for saving figures (i.e. has a `print_xyz`
-method), you can register it as the default handler for a given file type::
+If your backend implements support for saving figures (i.e. has a ``print_xyz`` method),
+you can register it as the default handler for a given file type::
 
     from matplotlib.backend_bases import register_backend
     register_backend('xyz', 'my_backend', 'XYZ File Format')

lib/matplotlib/testing/decorators.py

@@ -263,7 +263,7 @@ def image_comparison(baseline_images, extensions=None, tol=0,
                      style=("classic", "_classic_test_patch")):
     """
     Compare images generated by the test with those specified in
-    *baseline_images*, which must correspond, else an `ImageComparisonFailure`
+    *baseline_images*, which must correspond, else an `.ImageComparisonFailure`
     exception will be raised.
 
     Parameters