1.1 --- a/README.txt Sat Sep 15 01:21:12 2007 +0000
1.2 +++ b/README.txt Sat Sep 15 01:21:20 2007 +0000
1.3 @@ -10,14 +10,31 @@
1.4 Quick Start
1.5 -----------
1.6
1.7 -Try running the simple example:
1.8 +Try running the simple examples:
1.9
1.10 PYTHONPATH=. python examples/simple.py
1.11 +PYTHONPATH=. python examples/simple_create.py
1.12 +PYTHONPATH=. python examples/simple_managed.py
1.13 +PYTHONPATH=. python examples/simple_map.py
1.14 +PYTHONPATH=. python examples/simple_pmap.py
1.15 +PYTHONPATH=. python examples/simple_queue.py
1.16
1.17 (A simple example which shows how a limited number of processes can be used to
1.18 -perform a parallel computation.)
1.19 +perform a parallel computation. The simple_map.py program is a sequential
1.20 +version of the other programs.)
1.21 +
1.22 +The tutorial provides some information about the examples: docs/tutorial.xhtml
1.23 +
1.24 +The PyGmy raytracer modified to use pprocess can be run to investigate the
1.25 +potential for speed increases:
1.26
1.27 -Or studying some elementary tests:
1.28 +cd examples/PyGmy
1.29 +PYTHONPATH=../..:. python scene.py
1.30 +
1.31 +(This should produce a file called test.tif - a TIFF file containing a
1.32 +raytraced scene image.)
1.33 +
1.34 +There are some elementary tests:
1.35
1.36 PYTHONPATH=. python tests/create_loop.py
1.37 PYTHONPATH=. python tests/start_loop.py
1.38 @@ -33,15 +50,6 @@
1.39 fragments can be entered, and matching words and their locations will be
1.40 shown. Run the program without arguments to see more information.)
1.41
1.42 -Some examples are also found in the examples directory, notably the PyGmy
1.43 -raytracer modified to use pprocess:
1.44 -
1.45 -cd examples/PyGmy
1.46 -PYTHONPATH=../..:. python scene.py
1.47 -
1.48 -(This should produce a file called test.tif - a TIFF file containing a
1.49 -raytraced scene image.)
1.50 -
1.51 Contact, Copyright and Licence Information
1.52 ------------------------------------------
1.53
1.54 @@ -63,8 +71,8 @@
1.55 This software depends on standard library features which are stated as being
1.56 available only on "UNIX"; it has only been tested on a GNU/Linux system.
1.57
1.58 -New in parallel 0.2.6 (Changes since parallel 0.2.5)
1.59 -----------------------------------------------------
1.60 +New in parallel 0.3 (Changes since parallel 0.2.5)
1.61 +--------------------------------------------------
1.62
1.63 * Added managed callables: wrappers around callables which cause them to be
1.64 automatically managed by the exchange from which they were acquired.
1.65 @@ -72,7 +80,16 @@
1.66 sends the result of that function over the supplied channel when invoked.
1.67 * Added a Map class which attempts to emulate the built-in map function,
1.68 along with a pmap function using this class.
1.69 + * Added a Queue class which provides a simpler iterator-style interface to
1.70 + data produced by created processes.
1.71 + * Added a create method to the Exchange class and an exit convenience
1.72 + function to the module.
1.73 + * Changed the Exchange implementation to not block when attempting to start
1.74 + new processes beyond the process limit: such requests are queued and
1.75 + performed as running processes are completed. This permits programs using
1.76 + the start method to proceed to consumption of results more quickly.
1.77 * Extended and updated the examples.
1.78 + * Added Ubuntu Feisty (7.04) package support.
1.79
1.80 New in parallel 0.2.5 (Changes since parallel 0.2.4)
1.81 ----------------------------------------------------
1.82 @@ -143,6 +160,10 @@
1.83
1.84 ln -s packages/ubuntu-hoary/python2.4-parallel-pprocess/debian/
1.85
1.86 + Or:
1.87 +
1.88 + ln -s packages/ubuntu-feisty/python-pprocess/debian/
1.89 +
1.90 3. Run the package builder:
1.91
1.92 dpkg-buildpackage -rfakeroot