commit 2add9806688aea702fb6e46694bc81242e42b28e
author yang-g <yangg@google.com> Thu Aug 27 13:03:49 2015 -0700
committer yang-g <yangg@google.com> Thu Aug 27 13:03:49 2015 -0700
tree ac84d689f30607a38aa421db0800f9557038bd03
parent 0c63351381c17f5a5f26cfef1328d4fd62ba646b

Resolve comments

cpp/helloworld/README.md

diff --git a/cpp/helloworld/README.md b/cpp/helloworld/README.md
index ad98001..c406051 100644
--- a/cpp/helloworld/README.md
+++ b/cpp/helloworld/README.md
@@ -160,15 +160,15 @@
 is
 - bind a `CompletionQueue` to a rpc call
 - do something like a read or write, present with a unique `void*` tag
-- call `CompletionQueue::Next` to poll the events. If the tag appears, the
-  previous operation finishes.
+- call `CompletionQueue::Next` to wait for operations to complete. If a tag
+  appears, it indicates that the corresponding operation is complete.
 
 #### Async client
 
 The channel and stub creation code is the same as the sync client.
 
-- Initiate the rpc and create a handle for the rpc. Bind a `CompletionQueue` to
-  it.
+- Initiate the rpc and create a handle for the rpc. Bind the rpc to a
+  `CompletionQueue`.
 
     ```
     CompletionQueue cq;
@@ -182,8 +182,8 @@
     rpc->Finish(&reply, &status, (void*)1);
     ```
 
-- Poll the completion queue for the tag. The reply and status are ready once the
-  tag is returned.
+- Wait for the completion queue to return the next tag. The reply and status are
+  ready once the tag passed into the corresponding `Finish()` call is returned.
 
     ```
     void* got_tag;
@@ -198,8 +198,8 @@
 
 #### Async server
 
-The server implementation requests a rpc call with a tag and then poll the
-completion queue for the tag. The basic flow is
+The server implementation requests a rpc call with a tag and then wait for the
+completion queue to return the tag. The basic flow is
 
 - Build a server exporting the async service
 
@@ -221,8 +221,8 @@
     service.RequestSayHello(&context, &request, &responder, &cq, &cq, (void*)1);
     ```
 
-- Poll the completion queue for the tag. The context, request and responder are
-  ready once the tag is retrieved.
+- Wait for the completion queue to return the tag. The context, request and
+  responder are ready once the tag is retrieved.
 
     ```
     HelloReply reply;
@@ -236,8 +236,8 @@
     }
     ```
 
-- Poll the completion queue for the tag. The rpc is finished when the tag is
-  back.
+- Wait for the completion queue to return the tag. The rpc is finished when the
+  tag is back.
 
     ```
     void* got_tag;