[Python-checkins] cpython (merge 3.2 -> default): merge from 3.2

[senthil.kumaran]

http://hg.python.org/cpython/rev/bf6f306ad5cf
changeset:   74849:bf6f306ad5cf
parent:      74846:e9c3df45920e
parent:      74848:a352e24b9907
user:        Senthil Kumaran <senthil at uthcode.com>
date:        Thu Feb 09 18:27:48 2012 +0800
summary:
  merge from 3.2

Issue #9021 - Introduce copy module better in the docs.

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


diff --git a/Doc/library/copy.rst b/Doc/library/copy.rst
--- 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
--- 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.
 

-- 
Repository URL: http://hg.python.org/cpython