Skip to content

Conversation

@taleinat
Copy link
Contributor

@taleinattaleinat commented Jan 21, 2022

The docstring for the poll() methods of the select.poll and select.devpoll classes did not describe the expected units of the timeout argument (milliseconds). Previously this information was only available from the online documentation.

This is a potential source of confusion, because other poll() methods in the select module, such as epoll and kqueue Polling objects, use units of seconds (and were documented).

Include the units in the docstring description so that this information is at least available from interactive help.

Co-authored-by: Zane Bitter zbitter@redhat.com

https://bugs.python.org/issue41857

… select.depoll() doc-strings (pythonGH-22406). (cherry picked from commit 27df756) Co-authored-by: Zane Bitter <zbitter@redhat.com>
@taleinattaleinat changed the title bpo-41857: Document timeout arguments in select module[3.10]bpo-41857: Document timeout arguments in select moduleJan 21, 2022
@taleinattaleinat changed the title [3.10]bpo-41857: Document timeout arguments in select module[3.10]bpo-41857: Document timeout arguments in select module (GH-22406)Jan 21, 2022
@bedevere-botbedevere-bot added the docs Documentation in the Doc dir label Jan 21, 2022
@taleinattaleinat merged commit f6e5972 into python:3.10Jan 21, 2022
@taleinattaleinat deleted the backport-27df756-3.10 branch January 21, 2022 09:02
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docsDocumentation in the Doc dirskip news

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants

@taleinat@the-knights-who-say-ni@bedevere-bot@zaneb