Sundry minor elaborations of the text, mostly to test the cvs mirror

and notification propagation, but i got carried away and tried to fill
in some pieces otherwise slightly mysterious to me...

src/ZEO/README

@@ -41,22 +41,27 @@ Zope Enterprize Objects, ZEO 0.2
     import ZEO.ClientStorage
     Storage=ZEO.ClientStorage.ClientStorage(('',port_number))
 
-  You can specify a host name (rather than '') if you want.
-  The port number is, of course, the port number used to start the 
-  storage server.  The async switch tells the client to switch
-  itself to async mode (if and) when the asyncore main loop is called.
+  (See the custom_zodb.py.dist in the same ZEO directory as this
+  README for an example.)
+
+  You can specify a host name (rather than '') if you want.  The port
+  number is, of course, the port number used to start the storage
+  server.  The ClientStorage 'async' switch tells the client to switch
+  itself to async mode (if and) when the medusa asyncore main loop is
+  called.
 
   You can also give the name of a Unix domain socket file::
 
     import ZEO.ClientStorage
     Storage=ZEO.ClientStorage.ClientStorage(filename)
 
-  If you want a persistent client cache, you need to define the
-  environment variable, ZEO_CLIENT to a unique name for the
-  client. This is needed so that unique cache name files can be
-  computed. Otherwise, the client cache is stored in temporary files.
-  For example, to start two Zope processes with unique caches, use
-  something like:
+  If you want a persistent client cache which retains cache contents
+  across ClientStorage restarts, you need to define the environment
+  variable, ZEO_CLIENT, to a unique name for the client.  This is
+  needed so that unique cache name files can be computed.  Otherwise,
+  the client cache is stored in temporary files which are removed when
+  the ClientStorage shuts down.  For example, to start two Zope
+  processes with unique caches, use something like:
 
     python z2.py -P8700 ZEO_CLIENT=8700
     python z2.py -P8800 ZEO_CLIENT=8800
@@ -176,9 +181,9 @@ Zope Enterprize Objects, ZEO 0.2
 
     Known dependencies:
 
-      - Shared must be in the Python path. This is due to a lame
-        dependency on some Zope XML facilities used by ZODB for XML
-        export and import.
+      - The Zope lib/python/Shared directory must be in the Python
+        path. This is due to a lame dependency on some Zope XML
+        facilities used by ZODB for XML export and import.
 
       - ZServer should be in the Python path, or you should copy the
         version of asyncore.py from ZServer (from Zope 2.2 or CVS) to