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

and set comparisions.  Patch by Gareth Rees.

1 files changed, 4 insertions, 0 deletions

diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index fc6d020..0636686 100644
--- 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`.