Improve removal note

dstansby · dstansby · commit 6321e9483a8c · 2020-07-26T11:35:21.000+01:00
diff --git a/doc/api/next_api_changes/removals/18070-DS.rst b/doc/api/next_api_changes/removals/18070-DS.rst
@@ -1,13 +1,14 @@
-rcsetup removals
-~~~~~~~~~~~~~~~~
-
-The following functions in `~.rcsetup` have been removed:
+`.rcsetup` removals
+~~~~~~~~~~~~~~~~~~~
+The following functions in `matplotlib.rcsetup` have been removed:
 
 - ``validate_path_exists`` - use `os.path.exists` instead.
 - ``update_savefig_format`` - this just replaced ``'auto'`` with ``'png'``.
 - ``validate_animation_writer_path``.
 
-And the following values are no longer valid:
+Changes to valid rcParams
+~~~~~~~~~~~~~~~~~~~~~~~~~
+The following rcParam values are no longer valid:
 
 - Setting :rc:`savefig.format` to ``"auto"`` - use ``"png"`` instead.
 - Seeting :rc:`boxplot.whiskers` to ``"range"`` - set it to ``0, 100`` instead.
diff --git a/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst b/doc/api/prev_api_changes/api_changes_3.2.0/behavior.rst
@@ -293,7 +293,7 @@ Exception changes
 Various APIs that raised a `ValueError` for incorrectly typed inputs now raise
 `TypeError` instead: `.backend_bases.GraphicsContextBase.set_clip_path`,
 `.blocking_input.BlockingInput.__call__`, `.cm.register_cmap`, `.dviread.DviFont`,
-`.rcsetup.validate_hatch`, `.rcsetup.validate_animation_writer_path`, `.spines.Spine`,
+`.rcsetup.validate_hatch`, ``.rcsetup.validate_animation_writer_path``, `.spines.Spine`,
 many classes in the :mod:`matplotlib.transforms` module and :mod:`matplotlib.tri`
 package, and Axes methods that take a ``norm`` parameter.
 
