Add API note

dstansby · dstansby · commit de0674b49b73 · 2018-02-26T12:28:55.000Z
diff --git a/doc/api/next_api_changes/2018-02-15-AL-deprecations.rst b/doc/api/next_api_changes/2018-02-15-AL-deprecations.rst
@@ -1,5 +1,11 @@
 Deprecations
 ````````````
+The following modules are deprecated:
+
+- :mod:`matplotlib.compat.subprocess`. This was a python 2 workaround, but all the
+  functionality can now be found in the python 3 standard library
+  :mod:`subprocess`.
+
 The following functions and classes are deprecated:
 
 - ``cbook.GetRealpathAndStat`` (which is only a helper for
diff --git a/lib/matplotlib/compat/subprocess.py b/lib/matplotlib/compat/subprocess.py
@@ -13,9 +13,8 @@
 from matplotlib.cbook import warn_deprecated
 warn_deprecated(since='3.0',
                 name='matplotlib.compat.subprocess',
-                alternative='All the functionality provided by this module '
-                            'is available in the python 3 standard library '
-                            '"subprocess" module.',
+                alternative='the python 3 standard library '
+                            '"subprocess" module',
                 obj_type='module')
 
 __all__ = ['Popen', 'PIPE', 'STDOUT', 'check_output', 'CalledProcessError']
