Issue #24406: Add sentences on dict comparisons, similar to those for Sequence

and set comparisions.  Patch by Gareth Rees.

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index fc6d0206992abc0e13bb27fea06f61e16f3b08c1..0636686672adce28e3d97646f86931a84ce5b333 100644 (file)
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -3905,6 +3905,10 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
       Return a new view of the dictionary's values.  See the
       :ref:`documentation of view objects <dict-views>`.
 
+   Dictionaries compare equal if and only if they have the same ``(key,
+   value)`` pairs. Order comparisons ('<', '<=', '>=', '>') raise
+   :exc:`TypeError`.
+      
 .. seealso::
    :class:`types.MappingProxyType` can be used to create a read-only view
    of a :class:`dict`.