Review Changes

chemelnucfin · chemelnucfin · commit fe285ead442b · 2018-02-05T10:18:17.000-08:00
diff --git a/docs/spanner/usage.rst b/docs/spanner/usage.rst
@@ -89,11 +89,14 @@ Configuration
 
 Warnings about Multithreading and Multiprocessing
 -------------------------------------------------
-- Multiprocessing has been known to hang if ``client`` creation is before fork()
-  in the ProcessingPool().  The issue is under investigation, but may be only
-  happening on Macintosh and not Linux.  See `GRPC/GRPC#12455 <https://github.com/grpc/grpc/issues/12455#issuecomment-348578950>`_ for more information.
-
-- It is also possible that multithreading creates a segmentation fault.
+- When using multiprocessing, the application may hang if a
+  :class:~google.cloud.spanner_v1.client.Client instance is created before
+  :class:multiprocessing.Pool or :class:multiprocessing.Process invokes :func:os.fork.
+  The issue is under investigation, but may be only happening on Macintosh and not Linux.
+  See `GRPC/GRPC#12455 <https://github.com/grpc/grpc/issues/12455#issuecomment-348578950>`_ for more information.
+
+- It is also possible that multithreading creates a segmentation fault, but may have
+  been resolved.
   See `GRPC/GRPC#13327 <https://github.com/grpc/grpc/issues/13327#issuecomment-358415223>`_
   for more information.
 
