Issue #20100: Clarify that passing flags to epoll() has no effect

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index 6cec9f764bf647c0408b608000e161e78ed646bf..a465d25d8a58795dd1208d46590821cf3ca2c37a 100644 (file)
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -57,9 +57,7 @@ The module defines the following:
 
    (Only supported on Linux 2.5.44 and newer.) Return an edge polling object,
    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.
+   events. *sizehint* and *flags* are deprecated and completely ignored.
 
    See the :ref:`epoll-objects` section below for the methods supported by
    epolling objects.
@@ -77,6 +75,10 @@ The module defines the following:
       Support for the :keyword:`with` statement was added.
       The new file descriptor is now non-inheritable.
 
+   .. deprecated:: 3.4
+      The *flags* parameter.  ``select.EPOLL_CLOEXEC`` is used by default now.
+      Use :func:`os.set_inheritable` to make the file descriptor inheritable.
+
 
 .. function:: poll()