Break up the 'someos' docs classification based on a more user-focused scheme, including creation of a separate 'Concurrent Execution' section

ncoghlan · ncoghlan · commit bac9a53d007e · 2012-08-20T18:05:46.000+10:00
diff --git a/Doc/library/concurrency.rst b/Doc/library/concurrency.rst
@@ -0,0 +1,31 @@
+.. _concurrency:
+
+********************
+Concurrent Execution
+********************
+
+The modules described in this chapter provide support for concurrent
+execution of code. The appropriate choice of tool will depend on the
+task to be executed (CPU bound vs IO bound) and preferred style of
+development (event driven cooperative multitasking vs preemptive
+multitasking) Here's an overview:
+
+
+.. toctree::
+
+   threading.rst
+   multiprocessing.rst
+   concurrent.futures.rst
+   subprocess.rst
+   sched.rst
+   queue.rst
+   select.rst
+
+
+The following are support modules for some of the above services:
+
+.. toctree::
+
+   dummy_threading.rst
+   _thread.rst
+   _dummy_thread.rst
diff --git a/Doc/library/datatypes.rst b/Doc/library/datatypes.rst
@@ -25,8 +25,6 @@ The following modules are documented in this chapter:
    heapq.rst
    bisect.rst
    array.rst
-   sched.rst
-   queue.rst
    weakref.rst
    types.rst
    copy.rst
diff --git a/Doc/library/index.rst b/Doc/library/index.rst
@@ -57,7 +57,7 @@ the `Python Package Index <http://pypi.python.org/pypi>`_.
    fileformats.rst
    crypto.rst
    allos.rst
-   someos.rst
+   concurrency.rst
    ipc.rst
    netdata.rst
    markup.rst
diff --git a/Doc/library/ipc.rst b/Doc/library/ipc.rst
@@ -8,17 +8,17 @@ The modules described in this chapter provide mechanisms for different processes
 to communicate.
 
 Some modules only work for two processes that are on the same machine, e.g.
-:mod:`signal` and :mod:`subprocess`.  Other modules support networking protocols
+:mod:`signal` and :mod:`mmap`.  Other modules support networking protocols
 that two or more processes can used to communicate across machines.
 
 The list of modules described in this chapter is:
 
 
 .. toctree::
 
-   subprocess.rst
    socket.rst
    ssl.rst
-   signal.rst
    asyncore.rst
    asynchat.rst
+   signal.rst
+   mmap.rst
diff --git a/Doc/library/someos.rst b/Doc/library/someos.rst
diff --git a/Doc/library/text.rst b/Doc/library/text.rst
@@ -21,4 +21,6 @@ Python's built-in string type in :ref:`textseq`.
    textwrap.rst
    unicodedata.rst
    stringprep.rst
+   readline.rst
+   rlcompleter.rst
 
diff --git a/Misc/NEWS b/Misc/NEWS
@@ -55,6 +55,13 @@ Tools/Demos
 Documentation
 -------------
 
+- Create a 'Concurrent Execution' section in the docs, and split up the
+  'Optional Operating System Services' section to use a more user-centric
+  classification scheme (splitting them across the new CE section, IPC and
+  text processing). Operating system limitatons can be reflected with
+  the Sphinx :platform: tag, it doesn't make sense as part of the Table of
+  Contents.
+
 - Issue #4966: Bring the sequence docs up to date for the Py3k transition
   and the many language enhancements since they were original written
 
