matplotlib
diff --git a/‎doc/api/next_api_changes/deprecations/22148-OG.rst
Lines changed: 5 additions & 0 deletions b/‎doc/api/next_api_changes/deprecations/22148-OG.rst
Lines changed: 5 additions & 0 deletions
diff --git a/‎lib/matplotlib/__init__.py
Lines changed: 2 additions & 2 deletions b/‎lib/matplotlib/__init__.py
Lines changed: 2 additions & 2 deletions
diff --git a/‎lib/matplotlib/_enums.py
Lines changed: 2 additions & 2 deletions b/‎lib/matplotlib/_enums.py
Lines changed: 2 additions & 2 deletions
@@ -0,0 +1,5 @@
+Module ``docstring`` deprecated
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The module ``matplotlib.docstring`` is considered internal and public access
+is deprecated.
@@ -106,7 +106,7 @@
 
 # cbook must import matplotlib only within function
 # definitions, so it is safe to import from it here.
-from . import _api, _version, cbook, docstring, rcsetup
+from . import _api, _version, cbook, _docstring, rcsetup
 from matplotlib.cbook import MatplotlibDeprecationWarning, sanitize_sequence
 from matplotlib.cbook import mplDeprecation  # deprecated
 from matplotlib.rcsetup import validate_backend, cycler
@@ -593,7 +593,7 @@ def gen_candidates():
 _deprecated_remain_as_none = {}
 
 
-@docstring.Substitution(
+@_docstring.Substitution(
     "\n".join(map("- {}".format, sorted(rcsetup._validators, key=str.lower)))
 )
 class RcParams(MutableMapping, dict):
 
@@ -11,7 +11,7 @@
 """
 
 from enum import Enum, auto
-from matplotlib import docstring
+from matplotlib import _docstring
 
 
 class _AutoStringNameEnum(Enum):
@@ -179,5 +179,5 @@ def demo():
         + ", ".join([f"'{cs.name}'" for cs in CapStyle]) \
         + "}"
 
-docstring.interpd.update({'JoinStyle': JoinStyle.input_description,
+_docstring.interpd.update({'JoinStyle': JoinStyle.input_description,
                           'CapStyle': CapStyle.input_description})