1.1 --- a/README.txt Sun Jan 05 00:56:40 2014 +0100
1.2 +++ b/README.txt Wed Aug 19 11:31:24 2015 +0200
1.3 @@ -7,6 +7,12 @@
1.4 systems with multiple CPUs or multicore CPUs, processes should take advantage
1.5 of as many CPUs or cores as the operating system permits.
1.6
1.7 +Since pprocess distributes work to other processes, certain aspects of the
1.8 +behaviour of those processes may differ from the normal behaviour of such
1.9 +code. For example, any mutable objects distributed to other processes can
1.10 +still be modified, but any modifications will not be visible outside the
1.11 +processes making such modifications. The
1.12 +
1.13 Tutorial
1.14 --------
1.15
1.16 @@ -123,6 +129,22 @@
1.17 PYTHONPATH=. python examples/concurrency-sig/bottles.py
1.18 PYTHONPATH=. python examples/concurrency-sig/bottles_heartbeat.py
1.19
1.20 +Examples of Modifying Mutable Objects
1.21 +-------------------------------------
1.22 +
1.23 +Mutable objects can be modified in processes created by pprocess, but the
1.24 +modifications will not be visible in the parent process. The following
1.25 +examples illustrate the problem:
1.26 +
1.27 +PYTHONPATH=. python examples/simple_mutable.py
1.28 +PYTHONPATH=. python examples/simple_mutable_queue.py
1.29 +
1.30 +The former, non-parallel program will display the expected result of the
1.31 +computation, whereas the latter, parallel program will fail to do so. This is
1.32 +because the latter attempts to modify the input collection in order to use it
1.33 +as a result collection, but these modifications are not propagated back to the
1.34 +parent process.
1.35 +
1.36 Test Programs
1.37 -------------
1.38
1.39 @@ -167,6 +189,12 @@
1.40 available only on "UNIX"; it has only been tested repeatedly on a GNU/Linux
1.41 system, and occasionally on systems running OpenSolaris.
1.42
1.43 +New in pprocess 0.5.2 (Changes since pprocess 0.5.1)
1.44 +----------------------------------------------------
1.45 +
1.46 + * Added examples involving mutable objects and the inability of pprocess to
1.47 + automatically propagate changes to such objects back to parent processes.
1.48 +
1.49 New in pprocess 0.5.1 (Changes since pprocess 0.5)
1.50 --------------------------------------------------
1.51