Draft: draft-ietf-quic-transport

Commentary: I support Martin 's suggestions , but otherwise am fine with this .
Paragraph (version A):
A receiver sets initial credits for all streams by sending transport
parameters during the handshake (transport-parameters).  A receiver
sends MAX_STREAM_DATA (frame-max-stream-data) or MAX_DATA (frame-max-
data) frames to the sender to advertise additional credit.
Paragraph (version A):
A receiver advertises credit for a stream by sending a
MAX_STREAM_DATA frame with the Stream ID field set appropriately.  A
MAX_STREAM_DATA frame indicates the maximum absolute byte offset of a
stream.  A receiver could use the current offset of data consumed to
determine the flow control offset to be advertised.  A receiver MAY
send MAX_STREAM_DATA frames in multiple packets in order to make sure
that the sender receives an update before running out of flow control
credit, even if one of the packets is lost.
Paragraph (version A):
A receiver advertises credit for a connection by sending a MAX_DATA
frame, which indicates the maximum of the sum of the absolute byte
offsets of all streams.  A receiver maintains a cumulative sum of
bytes received on all streams, which is used to check for flow
control violations.  A receiver might use a sum of bytes consumed on
all streams to determine the maximum data limit to be advertised.
Paragraph (version A):
A receiver can advertise a larger offset by sending MAX_STREAM_DATA
or MAX_DATA frames.  Once a receiver advertises an offset, it MAY
advertise a smaller offset, but this has no effect.
Paragraph (version B):
A receiver sets initial limits for all streams by sending transport
parameters during the handshake (transport-parameters).  A receiver
sends MAX_STREAM_DATA (frame-max-stream-data) or MAX_DATA (frame-max-
data) frames to the sender to advertise larger limits.
Paragraph (version B):
A receiver can advertise a larger limit for a stream by sending a
MAX_STREAM_DATA frame with the Stream ID field set appropriately.  A
MAX_STREAM_DATA frame indicates the maximum absolute byte offset of a
stream.  A receiver could use the current offset of data consumed to
determine the flow control offset to be advertised.  A receiver MAY
send MAX_STREAM_DATA frames in multiple packets in order to make sure
that the sender receives an update before running out of flow
control, even if one of the packets is lost.
Paragraph (version B):
A receiver can advertise a larger limit for a connection by sending a
MAX_DATA frame, which indicates the maximum of the sum of the
absolute byte offsets of all streams.  A receiver maintains a
cumulative sum of bytes received on all streams, which is used to
check for flow control violations.  A receiver might use a sum of
bytes consumed on all streams to determine the maximum data limit to
be advertised.
Paragraph (version B):
Once a receiver advertises a limit for the connection or a stream, it
MAY advertise a smaller limit, but this has no effect.
Paragraph (version A):
If a sender runs out of flow control credit, it will be unable to
send new data and is considered blocked.  A sender SHOULD send a
STREAM_DATA_BLOCKED or DATA_BLOCKED frame to indicate it has data to
write but is blocked by flow control limits.  If a sender is blocked
for a period longer than the idle timeout (idle-timeout), the
connection might be closed even when data is available for
transmission.  To keep the connection from closing, a sender that is
flow control limited SHOULD periodically send a STREAM_DATA_BLOCKED
or DATA_BLOCKED frame when it has no ack-eliciting packets in flight.
Paragraph (version B):
If a sender has sent data up to the limit, it will be unable to send
new data and is considered blocked.  A sender SHOULD send a
STREAM_DATA_BLOCKED or DATA_BLOCKED frame to indicate it has data to
write but is blocked by flow control limits.  If a sender is blocked
for a period longer than the idle timeout (idle-timeout), the
connection might be closed even when data is available for
transmission.  To keep the connection from closing, a sender that is
flow control limited SHOULD periodically send a STREAM_DATA_BLOCKED
or DATA_BLOCKED frame when it has no ack-eliciting packets in flight.