From 59e7c8f1779254a6a5974ca329eb6f2438e1f6e1 Mon Sep 17 00:00:00 2001
From: Senthil Kumaran <senthil@uthcode.com>
Date: Thu, 9 Feb 2012 18:22:01 +0800
Subject: [PATCH] Issue #9021: Add an introduction to the copy module. Doc
 changes suggested by Terry Reedy.

---
 Doc/library/copy.rst | 6 +++++-
 Misc/NEWS            | 2 ++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/Doc/library/copy.rst b/Doc/library/copy.rst
index b3ce51f57e4..0f23a953985 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 fec58eae617..e912b49c453 100644
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -90,6 +90,8 @@ Core and Builtins
 Library
 -------
 
+- 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.
 
-- 
2.30.9