[issue22348] Documentation of asyncio.StreamWriter.drain()

Roundup Robot added the comment: New changeset 8224253ef4b7 by Victor Stinner in branch '3.4': Closes #22348: Rephrase asyncio.StreamWriter.drain() documentation https://hg.python.org/cpython/rev/8224253ef4b7 New changeset 1cad9e4bba40 by Victor Stinner in branch 'default': (Merge 3.4) Closes #2

[issue22348] Documentation of asyncio.StreamWriter.drain()

STINNER Victor added the comment: Sorry for the delay, I pushed asyncio-streams-drain-doc-water-limits.patch, thanks for your contribution Martin. -- ___ Python tracker ___

[issue22348] Documentation of asyncio.StreamWriter.drain()

Martin Richard added the comment: Here is an other patch which mentions high and low water limits. I think it's better to talk about it, since it tells extactly what a "full buffer" and "partially drained" means. On the other hand, StreamWriter wraps the transport but does not expose the set/

[issue22348] Documentation of asyncio.StreamWriter.drain()

STINNER Victor added the comment: IMO we should mention the write buffer limits ("high- and low-water limits for write flow control"). get_write_buffer_limits() and set_write_buffer_limits() methods of the transport are public, there is no reason to "hide" them. -- ___

[issue22348] Documentation of asyncio.StreamWriter.drain()

Changes by Martin Richard : -- hgrepos: -273 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pyth

[issue22348] Documentation of asyncio.StreamWriter.drain()

New submission from Martin Richard: Hi, Following the discussion on the python-tulip group, I'd like to propose a patch for the documentation of StreamWriter.drain(). This patch aims to give a better description of what drain() is intended to do, and when to use it. In particular, it highligh