merge from 3.2
Issue #9021 - Introduce copy module better in the docs.
diff --git a/Doc/library/copy.rst b/Doc/library/copy.rst
index 5ae79aa..0c68bd9 100644
--- a/Doc/library/copy.rst
+++ b/Doc/library/copy.rst
@@ -4,7 +4,11 @@
.. module:: copy
:synopsis: Shallow and deep copy operations.
-This module provides generic (shallow and deep) copying operations.
+Assignment statements in Python do not copy objects, they create bindings
+between a target and an object. For collections that are mutable or contain
+mutable items, a copy is sometimes needed so one can change one copy without
+changing the other. This module provides generic shallow and deep copy
+operations (explained below).
Interface summary:
diff --git a/Misc/NEWS b/Misc/NEWS
index 7fe19e0..146cbb5 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -484,6 +484,8 @@
make sure two listeners can't bind to the same socket/pipe (or any existing
socket/pipe).
+- Issue #9021: Add an introduction to the copy module documentation.
+
- Issue #6005: Examples in the socket library documentation use sendall, where
relevant, instead send method.