From ab294db7441bd112a7dba2aa1e9ceb33906a4066 Mon Sep 17 00:00:00 2001
From: Craig Tiller <craig.tiller@gmail.com>
Date: Tue, 17 Feb 2015 15:00:19 -0800
Subject: [PATCH] Add some comments

---
 include/grpc++/completion_queue.h | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/grpc++/completion_queue.h b/include/grpc++/completion_queue.h
index 665f29318f..c5267f8563 100644
--- a/include/grpc++/completion_queue.h
+++ b/include/grpc++/completion_queue.h
@@ -84,6 +84,8 @@ class CompletionQueue {
   grpc_completion_queue *cq() { return cq_; }
 
  private:
+  // Friend synchronous wrappers so that they can access Pluck(), which is
+  // a semi-private API geared towards the synchronous implementation.
   template <class R>
   friend class ::grpc::ClientReader;
   template <class W>
@@ -103,6 +105,8 @@ class CompletionQueue {
                                   const google::protobuf::Message &request,
                                   google::protobuf::Message *result);
 
+  // Wraps grpc_completion_queue_pluck.
+  // Cannot be mixed with calls to Next().
   bool Pluck(CompletionQueueTag *tag);
 
   grpc_completion_queue *cq_;  // owned
-- 
GitLab