[Python-checkins] bpo-34369: make kqueue.control() docs better reflect that timeout is positional-only (GH-9499)

[Tal Einat]

https://github.com/python/cpython/commit/d3747fd8fa91b768b73b60f2e2a14044e5404afa
commit: d3747fd8fa91b768b73b60f2e2a14044e5404afa
branch: 3.7
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: Tal Einat <taleinat at gmail.com>
date: 2019-07-11T17:16:45+03:00
summary:

bpo-34369: make kqueue.control() docs better reflect that timeout is positional-only (GH-9499)

(cherry picked from commit 79042ac4348ccc09344014f20dd49401579f8795)

Co-authored-by: Tal Einat <taleinat at gmail.com>

files:
M Doc/library/select.rst

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index 5b8fd7ee805c..7d65363e4931 100644
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -480,13 +480,14 @@ Kqueue Objects
    Create a kqueue object from a given file descriptor.
 
 
-.. method:: kqueue.control(changelist, max_events[, timeout=None]) -> eventlist
+.. method:: kqueue.control(changelist, max_events[, timeout]) -> eventlist
 
    Low level interface to kevent
 
-   - changelist must be an iterable of kevent object or ``None``
+   - changelist must be an iterable of kevent objects or ``None``
    - max_events must be 0 or a positive integer
-   - timeout in seconds (floats possible)
+   - timeout in seconds (floats possible); the default is ``None``,
+     to wait forever
 
    .. versionchanged:: 3.5
       The function is now retried with a recomputed timeout when interrupted by