rpc: Document what is actually going on with stream optimism.
In brief: we do correct implement correct optimistic vs nonoptimistic behavior for RPC streams. Only our documentation was wrong. Subsequent commits will fix our documentation more.
Closes #1583 (closed).
Edited by Nick Mathewson