classification
Title: asyncio: set_write_buffer_limits() doc doesn't specify unit of the parameters
Type: Stage: needs patch
Components: asyncio, Documentation Versions: Python 3.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Mariatta Nosy List: Mariatta, docs@python, haypo, yselivanov
Priority: normal Keywords: easy

Created on 2017-03-28 13:18 by haypo, last changed 2017-04-12 01:34 by Mariatta.

Messages (3)
msg290712 - (view) Author: STINNER Victor (haypo) * (Python committer) Date: 2017-03-28 13:18
The asyncio set_write_buffer_limits() documentation doesn't specify unit of high and low parameters. Moreover, it would to explain better the effect of high and low:

* pause_writing() is called when the buffer size becomes larger or equal to high
* (if writing is pause) resume_writing() is called when the buffer size becomes smaller or equal to low
msg290713 - (view) Author: STINNER Victor (haypo) * (Python committer) Date: 2017-03-28 13:19
See also https://github.com/asyncio-doc/asyncio-doc/issues/17 for a more general documentation request on asyncio parameters (on the external asyncio doc).
msg290716 - (view) Author: STINNER Victor (haypo) * (Python committer) Date: 2017-03-28 13:55
It would also be nice to:

* link to set_write_buffer_limits() from drain()
* link to set_write_buffer_limits() from pause_writing() / resume_writing()
* mention asyncio default values for set_write_buffer_limits(): low=16 kB, high=64 kB (kb? kib? i never know :-/)
History
Date User Action Args
2017-04-12 01:34:47Mariattasetstage: needs patch
2017-04-12 01:34:38Mariattasetassignee: docs@python -> Mariatta

nosy: + Mariatta
2017-03-28 13:55:57hayposetmessages: + msg290716
2017-03-28 13:19:24hayposetmessages: + msg290713
2017-03-28 13:18:59haypocreate