diff --git a/Doc/library/configparser.rst b/Doc/library/configparser.rst
index 1a88bbd2d53..5b20bb70e40 100644
--- a/Doc/library/configparser.rst
+++ b/Doc/library/configparser.rst
@@ -1064,6 +1064,11 @@ ConfigParser Objects
       given *section*.  Optional arguments have the same meaning as for the
       :meth:`get` method.
 
+      .. versionchanged:: 3.2
+
+         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)