Review Changes

chemelnucfin · chemelnucfin · commit 40ffe18af944 · 2018-02-22T13:36:42.000-08:00
diff --git a/docs/spanner/usage.rst b/docs/spanner/usage.rst
@@ -89,13 +89,11 @@ 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.
-  See `GRPC/GRPC#13327 <https://github.com/grpc/grpc/issues/13327#issuecomment-358415223>`_
-  for more information.
+- 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.
 
 Next Step
 ---------
