tree 9675a0de87b5d888e4ef87a59be9bf8fe0d37807
parent c00934943ed4007d60e5af6664bbec46c9392dd6
author Bogdan Caprita <caprita@google.com> 1405718596 -0700
committer Bogdan Caprita <caprita@google.com> 1405718602 -0700

veyron2/vdl/gen: attempt at clarifying the semantics of the stream API through
comments.

As a developer, I had to either peek at veyron2/ipc/model.go, or at the
implementation in veyron/runtimes/google/ipc to figure out how to correctly use
the API generated by the stub compiler. Specifically, it wasn't clear what
happens when you call Recv, Finish, Cancel (for an incoming stream) or Send,
CloseSend, Finish, and Cancel (for an outgoing stream) in different orders on
the client.  Some things are still unclear (see TODOs) and some of my
clarifications are likely wrong.

Change-Id: I1e205cbbe271f971e43e51978fcccb390714c252