whatsnew: epoll supports with.

Also reworded the description of the feature in the docs.

2 files changed, 17 insertions, 3 deletions

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index 524e411f2cc..f5f90bbf96b 100644
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -58,9 +58,14 @@ The module defines the following:
    which can be used as Edge or Level Triggered interface for I/O
    events. *sizehint* is deprecated and completely ignored. *flags* can be set
    to :const:`EPOLL_CLOEXEC`, which causes the epoll descriptor to be closed
-   automatically when :func:`os.execve` is called. See section
-   :ref:`epoll-objects` below for the methods supported by epolling objects.
-   They also support the :keyword:`with` statement.
+   automatically when :func:`os.execve` is called.
+
+   See the :ref:`epoll-objects` section below for the methods supported by
+   epolling objects.
+
+   ``epoll`` objects support the context management protocol: when used in a
+   :keyword:`with` statement, the new file descriptor is automatically closed
+   at the end of the block.
 
    The new file descriptor is :ref:`non-inheritable <fd_inheritance>`.
 
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
index 4a097d25603..5b682439450 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -851,6 +851,15 @@ New :func:`resource.prlimit` function and Linux specific constants.
 (Contributed by Christian Heimes in :issue:`16595` and :issue:`19324`.)
 
 
+select
+------
+
+:class:`~select.epoll` objects now support the context management protocol.
+When used in a :keyword:`with` statement, the :meth:`~select.epoll.close`
+method will be called automatically at the end of the block.  (Contributed
+by Serhiy Storchaka in :issue:`16488`.)
+
+
 shelve
 ------