Merge pull request #16595 from anntzer/docrefs

anntzer · web-flow · commit 3b04c7dd0fc8 · 2020-02-28T11:48:08.000+01:00
Minor docstring/references update.
diff --git a/doc/devel/MEP/MEP22.rst b/doc/devel/MEP/MEP22.rst
@@ -180,8 +180,8 @@ Methods for **Backend implementation**
 Backward compatibility
 ======================
 
-For backward compatibility added a 'navigation' key to
-`rcsetup.validate_toolbar`, that is used for Navigation classes
+For backward compatibility added 'navigation' to the list of values
+supported by :rc:`toolbar`, that is used for Navigation classes
 instantiation instead of the NavigationToolbar classes
 
 With this parameter, it makes it transparent to anyone using the
diff --git a/doc/missing-references.json b/doc/missing-references.json
@@ -1481,9 +1481,6 @@
     "next_whats_new": [
       "doc/users/next_whats_new/README.rst:6"
     ],
-    "number": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.figure:8"
-    ],
     "numpy.datetime64": [
       "doc/api/prev_api_changes/api_changes_2.1.0.rst:95",
       "doc/faq/howto_faq.rst:18",
@@ -1518,15 +1515,6 @@
     "pyplot.set_loglevel": [
       "doc/users/prev_whats_new/whats_new_3.1.0.rst:377"
     ],
-    "quiverkey": [
-      "lib/matplotlib/quiver.py:docstring of matplotlib.quiver.Quiver:247"
-    ],
-    "rc_file_defaults": [
-      "lib/matplotlib/pyplot.py:docstring of matplotlib.pyplot.rcdefaults:18"
-    ],
-    "rcsetup.validate_toolbar": [
-      "doc/devel/MEP/MEP22.rst:183"
-    ],
     "remove_canvas": [
       "doc/devel/MEP/MEP23.rst:63"
     ],
diff --git a/lib/matplotlib/__init__.py b/lib/matplotlib/__init__.py
@@ -955,7 +955,7 @@ def rcdefaults():
 
     See Also
     --------
-    rc_file_defaults
+    matplotlib.rc_file_defaults
         Restore the `.rcParams` from the rc file originally loaded by
         Matplotlib.
     matplotlib.style.use
diff --git a/lib/matplotlib/fontconfig_pattern.py b/lib/matplotlib/fontconfig_pattern.py
@@ -5,12 +5,9 @@
    https://www.freedesktop.org/software/fontconfig/fontconfig-user.html
 """
 
-# This class is defined here because it must be available in:
-#   - The old-style config framework (:file:`rcsetup.py`)
-#   - The font manager (:file:`font_manager.py`)
-
-# It probably logically belongs in :file:`font_manager.py`, but placing it
-# there would have created cyclical dependency problems.
+# This class logically belongs in `matplotlib.font_manager`, but placing it
+# there would have created cyclical dependency problems, because it also needs
+# to be available from `matplotlib.rcsetup` (for parsing matplotlibrc files).
 
 from functools import lru_cache
 import re
diff --git a/lib/matplotlib/quiver.py b/lib/matplotlib/quiver.py
@@ -188,7 +188,7 @@
 
 See Also
 --------
-quiverkey : Add a key to a quiver plot.
+.Axes.quiverkey : Add a key to a quiver plot.
 """ % docstring.interpd.params
 
 
