diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
index 5da5cd9f96d..f51c580c0de 100644
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -1120,6 +1120,11 @@ ConfigParser Objects
       given *section*.  Optional arguments have the same meaning as for the
       :meth:`get` method.
 
+   .. versionchanged:: 3.8
+      Items present in *vars* no longer appear in the result.  The previous
+      behaviour mixed actual parser options with variables provided for
+      interpolation.
+
 
    .. method:: set(section, option, value)