Commit fcb444a8 authored by Mark Summerfield's avatar Mark Summerfield

Added cross-references plus a note about dict & list shallow copying.

parent 691632f1
...@@ -54,6 +54,10 @@ file, socket, window, array, or any similar types. It does "copy" functions and ...@@ -54,6 +54,10 @@ file, socket, window, array, or any similar types. It does "copy" functions and
classes (shallow and deeply), by returning the original object unchanged; this classes (shallow and deeply), by returning the original object unchanged; this
is compatible with the way these are treated by the :mod:`pickle` module. 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 .. versionchanged:: 2.5
Added copying functions. Added copying functions.
......
...@@ -8,8 +8,9 @@ ...@@ -8,8 +8,9 @@
The :mod:`mutex` module defines a class that allows mutual-exclusion via The :mod:`mutex` module defines a class that allows mutual-exclusion via
acquiring and releasing locks. It does not require (or imply) threading or acquiring and releasing locks. It does not require (or imply)
multi-tasking, though it could be useful for those purposes. :mod:`threading` or multi-tasking, though it could be useful for those
purposes.
The :mod:`mutex` module defines the following class: The :mod:`mutex` module defines the following class:
......
...@@ -7,10 +7,11 @@ ...@@ -7,10 +7,11 @@
The :mod:`Queue` module implements a multi-producer, multi-consumer FIFO queue. 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 exchanged safely between multiple threads. The :class:`Queue` class in this
module implements all the required locking semantics. It depends on the 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: The :mod:`Queue` module defines the following class and exception:
......
...@@ -13,9 +13,11 @@ ...@@ -13,9 +13,11 @@
single: semaphores, binary single: semaphores, binary
This module provides low-level primitives for working with multiple threads 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 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:: .. index::
single: pthreads single: pthreads
......
...@@ -8,6 +8,7 @@ ...@@ -8,6 +8,7 @@
This module constructs higher-level threading interfaces on top of the lower This module constructs higher-level threading interfaces on top of the lower
level :mod:`thread` module. level :mod:`thread` module.
See also the :mod:`mutex` and :mod:`Queue` modules.
The :mod:`dummy_threading` module is provided for situations where The :mod:`dummy_threading` module is provided for situations where
:mod:`threading` cannot be used because :mod:`thread` is missing. :mod:`threading` cannot be used because :mod:`thread` is missing.
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment