Terry J. Reedy added the comment: The intro paragraph currently (3.2a) consists of "This module provides generic (shallow and deep) copying operations." This could be expanded to ''' Assignment statements create bindings between a target and an object. They never duplicate or copy an existing 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. Sequences can be shallow copied by slicing the entire sequence(s[:]). (See below for the meaning of 'shallow'.) Some objects can be shallow copied with their class constructors (tuple, list, set, dict). This module provides generic shallow *and* deep copying operations. The latter is not otherwise available in an single operation or call.''' ---------- nosy: +tjreedy versions: +Python 3.1 _______________________________________ Python tracker http://bugs.python.org/issue9021 _______________________________________

Senthil Kumaran added the comment: I am +0 on this change. The existing introduction is fine and the discussion where shallow and deep copy is discussed is more important. It is okay to assume that the reader is aware of the assignment operation nature, i.e. it does not create a copy and you need this module. The doc change suggested by Terry could be helpful in the tutorial where a copy module is mentioned. ---------- nosy: +orsenthil _______________________________________ Python tracker http://bugs.python.org/issue9021 _______________________________________

Senthil Kumaran added the comment:

Can you post a link to this tutorial here?

Section 9.1 and 9.2 of the docs.python.org/tutorial It may not be as explicit as you might want it to be, but it does sets up background that assignments do not copy the object. ---------- _______________________________________ Python tracker http://bugs.python.org/issue9021 _______________________________________

Roundup Robot added the comment: New changeset a352e24b9907 by Senthil Kumaran in branch '3.2': Issue #9021 - Introduce copy module better. Doc changes suggested by Terry http://hg.python.org/cpython/rev/a352e24b9907 New changeset bf6f306ad5cf by Senthil Kumaran in branch 'default': merge from 3.2 http://hg.python.org/cpython/rev/bf6f306ad5cf ---------- _______________________________________ Python tracker http://bugs.python.org/issue9021 _______________________________________

anatoly techtonik added the comment: Perfectionist in me says that now copy.copy theory should be diluted with examples for those who can't grasp the concept of "binding of variables", but the patch perfectly covers the original user story. Thanks. ---------- _______________________________________ Python tracker http://bugs.python.org/issue9021 _______________________________________