Merge heads

Doc/library/asynchat.rst

@@ -10,6 +10,9 @@
 
 --------------
 
+Note: This module exists for backwards compatibility only.  For new code we
+recommend using :module:`asyncio`.
+
 This module builds on the :mod:`asyncore` infrastructure, simplifying
 asynchronous clients and servers and making it easier to handle protocols
 whose elements are terminated by arbitrary strings, or are of variable length.

Doc/library/asyncore.rst

@@ -13,6 +13,9 @@
 
 --------------
 
+Note: This module exists for backwards compatibility only.  For new code we
+recommend using :module:`asyncio`.
+
 This module provides the basic infrastructure for writing asynchronous  socket
 service clients and servers.
 

Doc/library/concurrency.rst

@@ -20,9 +20,6 @@ multitasking). Here's an overview:
    subprocess.rst
    sched.rst
    queue.rst
-   select.rst
-   selectors.rst
-   asyncio.rst
 
 
 The following are support modules for some of the above services:

Doc/library/ipc.rst

@@ -18,6 +18,9 @@ The list of modules described in this chapter is:
 
    socket.rst
    ssl.rst
+   select.rst
+   selectors.rst
+   asyncio.rst
    asyncore.rst
    asynchat.rst
    signal.rst