[Python-checkins] cpython: Issue #16853: Mention the new selectors module in the select module

[victor.stinner]

http://hg.python.org/cpython/rev/142ff216e4b4
changeset:   85527:142ff216e4b4
user:        Victor Stinner <victor.stinner at gmail.com>
date:        Wed Sep 04 20:40:13 2013 +0200
summary:
  Issue #16853: Mention the new selectors module in the select module

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


diff --git a/Doc/library/select.rst b/Doc/library/select.rst
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -14,6 +14,14 @@
 It cannot be used on regular files to determine whether a file has grown since
 it was last read.
 
+.. note::
+
+   The :mod:`selectors` module allows high-level and efficient I/O
+   multiplexing, built upon the :mod:`select` module primitives. Users are
+   encouraged to use the :mod:`selectors` module instead, unless they want
+   precise control over the OS-level primitives used.
+
+
 The module defines the following:
 
 

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