bpo-43443: Clarify difference between shelve objects and dicts (GH-27004) (GH-27369)

(cherry picked from commit c97c2a050cf753003012ae3f08e035326b8f6167)

Co-authored-by: Serhiy Storchaka <storchaka@gmail.com>

diff --git a/Doc/library/shelve.rst b/Doc/library/shelve.rst
index 07caf91d5b7d994dd8dccdb118b41a2e7d66d4fb..1031888a5889b79bb19f710861f6a1d63b17f21a 100644 (file)
--- a/Doc/library/shelve.rst
+++ b/Doc/library/shelve.rst
@@ -60,7 +60,8 @@ lots of shared  sub-objects.  The keys are ordinary strings.
    to load a shelf from an untrusted source.  Like with pickle, loading a shelf
    can execute arbitrary code.
 
-Shelf objects support all methods supported by dictionaries.  This eases the
+Shelf objects support most of methods and operations supported by dictionaries
+(except copying, constructors and operators ``|`` and ``|=``).  This eases the
 transition from dictionary based scripts to those requiring persistent storage.
 
 Two additional methods are supported: