bpo-37585: Add clarification regarding comparing dict.values() (GH-14954)
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 0a565c3..c78f4ba 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -4357,6 +4357,14 @@
Return a new view of the dictionary's values. See the
:ref:`documentation of view objects <dict-views>`.
+ An equality comparison between one ``dict.values()`` view and another
+ will always return ``False``. This also applies when comparing
+ ``dict.values()`` to itself::
+
+ >>> d = {'a': 1}
+ >>> d.values() == d.values()
+ False
+
Dictionaries compare equal if and only if they have the same ``(key,
value)`` pairs. Order comparisons ('<', '<=', '>=', '>') raise
:exc:`TypeError`.