[Python-checkins] cpython (3.5): Issue #20100: Clarify that passing flags to epoll() has no effect

[berker.peksag]

https://hg.python.org/cpython/rev/9023c4f5d467
changeset:   103632:9023c4f5d467
branch:      3.5
parent:      103626:65a1abf4b432
user:        Berker Peksag <berker.peksag at gmail.com>
date:        Sun Sep 11 15:45:32 2016 +0300
summary:
  Issue #20100: Clarify that passing flags to epoll() has no effect

files:
  Doc/library/select.rst |  8 +++++---
  1 files changed, 5 insertions(+), 3 deletions(-)


diff --git a/Doc/library/select.rst b/Doc/library/select.rst
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -57,9 +57,7 @@
 
    (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 @@
       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()
 

-- 
Repository URL: https://hg.python.org/cpython