From: Victor Stinner <victor.stinner@gmail.com>
Date: Wed, 4 Sep 2013 18:40:13 +0000 (+0200)
Subject: Issue #16853: Mention the new selectors module in the select module
X-Git-Tag: v3.4.0a2~32
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=73821c47dcf56b02a30ab9ab524f0c0fc2875c22;p=thirdparty%2FPython%2Fcpython.git

Issue #16853: Mention the new selectors module in the select module
---

diff --git a/Doc/library/select.rst b/Doc/library/select.rst
index 02ce775461bb..524e411f2cc3 100644
--- a/Doc/library/select.rst
+++ b/Doc/library/select.rst
@@ -14,6 +14,14 @@ it also works for other file types (in particular, on Unix, it works on pipes).
 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: