[Python-checkins] r57954 - python/trunk/Doc/library/copy.rst python/trunk/Doc/library/mutex.rst python/trunk/Doc/library/queue.rst python/trunk/Doc/library/thread.rst python/trunk/Doc/library/threading.rst

[mark.summerfield]

Author: mark.summerfield
Date: Tue Sep  4 10:16:15 2007
New Revision: 57954

Modified:
   python/trunk/Doc/library/copy.rst
   python/trunk/Doc/library/mutex.rst
   python/trunk/Doc/library/queue.rst
   python/trunk/Doc/library/thread.rst
   python/trunk/Doc/library/threading.rst
Log:
Added cross-references plus a note about dict & list shallow copying.



Modified: python/trunk/Doc/library/copy.rst
==============================================================================
--- python/trunk/Doc/library/copy.rst	(original)
+++ python/trunk/Doc/library/copy.rst	Tue Sep  4 10:16:15 2007
@@ -54,6 +54,10 @@
 classes (shallow and deeply), by returning the original object unchanged; this
 is compatible with the way these are treated by the :mod:`pickle` module.
 
+Shallow copies of dictionaries can be made using :meth:`dict.copy`, and
+of lists by assigning a slice of the entire list, for example,
+``copied_list = original_list[:]``.
+
 .. versionchanged:: 2.5
    Added copying functions.
 

Modified: python/trunk/Doc/library/mutex.rst
==============================================================================
--- python/trunk/Doc/library/mutex.rst	(original)
+++ python/trunk/Doc/library/mutex.rst	Tue Sep  4 10:16:15 2007
@@ -8,8 +8,9 @@
 
 
 The :mod:`mutex` module defines a class that allows mutual-exclusion via
-acquiring and releasing locks. It does not require (or imply) threading or
-multi-tasking, though it could be useful for those purposes.
+acquiring and releasing locks. It does not require (or imply)
+:mod:`threading` or multi-tasking, though it could be useful for those
+purposes.
 
 The :mod:`mutex` module defines the following class:
 

Modified: python/trunk/Doc/library/queue.rst
==============================================================================
--- python/trunk/Doc/library/queue.rst	(original)
+++ python/trunk/Doc/library/queue.rst	Tue Sep  4 10:16:15 2007
@@ -7,10 +7,11 @@
 
 
 The :mod:`Queue` module implements a multi-producer, multi-consumer FIFO queue.
-It is especially useful in threads programming when information must be
+It is especially useful in threaded programming when information must be
 exchanged safely between multiple threads.  The :class:`Queue` class in this
 module implements all the required locking semantics.  It depends on the
-availability of thread support in Python.
+availability of thread support in Python; see the :mod:`threading`
+module.
 
 The :mod:`Queue` module defines the following class and exception:
 

Modified: python/trunk/Doc/library/thread.rst
==============================================================================
--- python/trunk/Doc/library/thread.rst	(original)
+++ python/trunk/Doc/library/thread.rst	Tue Sep  4 10:16:15 2007
@@ -13,9 +13,11 @@
    single: semaphores, binary
 
 This module provides low-level primitives for working with multiple threads
-(a.k.a. :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple threads of
+(also called :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple threads of
 control sharing their global data space.  For synchronization, simple locks
-(a.k.a. :dfn:`mutexes` or :dfn:`binary semaphores`) are provided.
+(also called :dfn:`mutexes` or :dfn:`binary semaphores`) are provided.
+The :mod:`threading` module provides an easier to use and higher-level
+threading API built on top of this module.
 
 .. index::
    single: pthreads

Modified: python/trunk/Doc/library/threading.rst
==============================================================================
--- python/trunk/Doc/library/threading.rst	(original)
+++ python/trunk/Doc/library/threading.rst	Tue Sep  4 10:16:15 2007
@@ -8,6 +8,7 @@
 
 This module constructs higher-level threading interfaces on top of the  lower
 level :mod:`thread` module.
+See also the :mod:`mutex` and :mod:`Queue` modules.
 
 The :mod:`dummy_threading` module is provided for situations where
 :mod:`threading` cannot be used because :mod:`thread` is missing.