Make PacketReader/PacketWriter interfaces async-only.

blimp/net/packet_reader.h

Index: blimp/net/packet_reader.h
diff --git a/blimp/net/packet_reader.h b/blimp/net/packet_reader.h
index 407e2fdd2c1d7f3fc7343404a0e2bf41bf95a7e8..cbbf7ff6055a8bf07208e665ee420df462eab7d4 100644
--- a/blimp/net/packet_reader.h
+++ b/blimp/net/packet_reader.h
@@ -18,14 +18,13 @@ class BLIMP_NET_EXPORT PacketReader {
   virtual ~PacketReader() {}
 
   // Reads a packet from the connection.
-  // Returns the size of the packet, in bytes, if the read operation executed
-  // successfully.
-  // Returns ERR_IO_PENDING if the operation will be executed asynchronously.
-  //     |cb| is later invoked with the packet size or an error code.
-  // All other return values indicate errors and caller should stop using this
-  // reader.
-  virtual int ReadPacket(const scoped_refptr<net::GrowableIOBuffer>& buf,
-                         const net::CompletionCallback& cb) = 0;
+  // Passes net::OK to |cb| if the read operation executed successfully.
+  // Sets |buf.offset()| to the received message's size, and invokes |cb| with
+  // net::OK result on success.
+  // All other values indicate errors.
+  // |callback| must not be invoked if |this| is deleted.

[Wez, 2015/12/01 22:34:45]

nit: must -> will

That way the comment describes the semantics from the PoV of what callers can
expect.

[Kevin M, 2015/12/02 02:02:37]

Done.

+  virtual void ReadPacket(const scoped_refptr<net::GrowableIOBuffer>& buf,
+                          const net::CompletionCallback& cb) = 0;
 };
 
 }  // namespace blimp