Add note to asyncore/asynchat recommending asyncio for new code.

diff --git a/Doc/library/asynchat.rst b/Doc/library/asynchat.rst
index 55c61d7e68f35b27e6c2e62083e80615e8d4180e..7050f0c5a3bfcd53ff920740d99c7499e9521d12 100644 (file)
--- a/Doc/library/asynchat.rst
+++ b/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.

diff --git a/Doc/library/asyncore.rst b/Doc/library/asyncore.rst
index 8f494d0e58a50300208ffc8dc8bd590257b63ec3..d0a30f8ae6c8db03565b36d9712a3f1f545f98dc 100644 (file)
--- a/Doc/library/asyncore.rst
+++ b/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.