bpo-37051: Refine note on what objects are hashable (GH-13587)

diff --git a/Doc/glossary.rst b/Doc/glossary.rst
index d3ce36525519986c36facdc0da37c54bd460bec8..177df54ef215d4f2bc70615262d146ad2a115cb4 100644 (file)
--- a/Doc/glossary.rst
+++ b/Doc/glossary.rst
@@ -512,8 +512,10 @@ Glossary
       Hashability makes an object usable as a dictionary key and a set member,
       because these data structures use the hash value internally.
 
-      All of Python's immutable built-in objects are hashable; mutable
-      containers (such as lists or dictionaries) are not.  Objects which are
+      Most of Python's immutable built-in objects are hashable; mutable
+      containers (such as lists or dictionaries) are not; immutable
+      containers (such as tuples and frozensets) are only hashable if
+      their elements are hashable.  Objects which are
       instances of user-defined classes are hashable by default.  They all
       compare unequal (except with themselves), and their hash value is derived
       from their :func:`id`.