X-Git-Url: https://wannabe.guru.org/gitweb/?a=blobdiff_plain;f=docs%2Fpyutils.parallelize.rst;h=722d4746c9def612643accf5758cc907adabcb51;hb=64a79338f8fc88daa19dc56d0dc54e5cc23553d8;hp=c53882d361bb8b0872e7e2b7155ab01fa0b7b099;hpb=1c60a8d9ae5a162f8d309b48f8a07ee6946f3e25;p=pyutils.git

diff --git a/docs/pyutils.parallelize.rst b/docs/pyutils.parallelize.rst
index c53882d..722d474 100644
--- a/docs/pyutils.parallelize.rst
+++ b/docs/pyutils.parallelize.rst
@@ -1,6 +1,10 @@
 pyutils.parallelize package
 ===========================
 
+This package contains code related to parallelization including some
+utilities (:file:`thread_utils.py`) and a frameworks for simple
+parallelization (everything else).
+
 Submodules
 ----------
 
@@ -10,6 +14,24 @@ pyutils.parallelize.deferred\_operand module
 .. automodule:: pyutils.parallelize.deferred_operand
    :members:
    :undoc-members:
+   :exclude-members: __repr__,
+                     and_,
+                     bool,
+                     delitem,
+                     getitem,
+                     invert,
+                     is_,
+                     is_not,
+                     lshift,
+                     matmul,
+                     mod,
+                     neg,
+                     or_,
+                     pos,
+                     rshift,
+                     setitem,
+                     truth,
+                     xor
    :show-inheritance:
 
 pyutils.parallelize.executors module
@@ -31,6 +53,16 @@ pyutils.parallelize.parallelize module
 pyutils.parallelize.smart\_future module
 ----------------------------------------
 
+Defines a SmartFuture class that is part of the parallelization
+framework.  A SmartFuture is a kind of Future (i.e. a representation
+of the result of asynchronous processing that may know its value or
+not depending on whether the asynchronous operation has completed).
+Whereas normal Python Futures must be waited on or resolved manually,
+a SmartFuture automatically waits for its result to be known as soon
+as it is utilized in an expression that demands its value.
+
+Also contains some utilility code for waiting for one/many futures.
+
 .. automodule:: pyutils.parallelize.smart_future
    :members:
    :undoc-members:
@@ -47,6 +79,11 @@ pyutils.parallelize.thread\_utils module
 Module contents
 ---------------
 
+This module contains a framework for easy Python parallelization.  To
+see an example of how it is used, look at examples/wordle/...
+
+This module also contains some utilities that deal with parallelization.
+
 .. automodule:: pyutils.parallelize
    :members:
    :undoc-members: