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

[ambv]

https://github.com/python/cpython/commit/563e05743c8f31366db7ef35a00e396c9f442b17
commit: 563e05743c8f31366db7ef35a00e396c9f442b17
branch: 3.10
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: ambv <lukasz at langa.pl>
date: 2021-07-26T21:32:36+02:00
summary:

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

(cherry picked from commit c97c2a050cf753003012ae3f08e035326b8f6167)

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

files:
M Doc/library/shelve.rst

diff --git a/Doc/library/shelve.rst b/Doc/library/shelve.rst
index 07caf91d5b7d9..1031888a5889b 100644
--- 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: