From: Berker Peksag <berker.peksag@gmail.com>
Date: Sun, 11 Sep 2016 12:45:32 +0000 (+0300)
Subject: Issue #20100: Clarify that passing flags to epoll() has no effect
X-Git-Tag: v3.6.0b1~50^2
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=1c697a56ba208665ed3db5c6bae48774cc7f552d;p=python

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

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index 6cec9f764b..a465d25d8a 100644
--- 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()