Closes #18959: move optparse and imp to new "superseded modules" chapter

4 files changed, 15 insertions, 2 deletions

diff --git a/Doc/library/allos.rst b/Doc/library/allos.rst
index bf91717..f7105d8 100644
--- a/Doc/library/allos.rst
+++ b/Doc/library/allos.rst
@@ -16,7 +16,6 @@ but they are available on most other systems as well.  Here's an overview:
    io.rst
    time.rst
    argparse.rst
-   optparse.rst
    getopt.rst
    logging.rst
    logging.config.rst
diff --git a/Doc/library/index.rst b/Doc/library/index.rst
index 81289a5..277feb1 100644
--- a/Doc/library/index.rst
+++ b/Doc/library/index.rst
@@ -73,4 +73,5 @@ the `Python Package Index <http://pypi.python.org/pypi>`_.
    misc.rst
    windows.rst
    unix.rst
+   superseded.rst
    undoc.rst
diff --git a/Doc/library/modules.rst b/Doc/library/modules.rst
index d89ef10..6b2a40a 100644
--- a/Doc/library/modules.rst
+++ b/Doc/library/modules.rst
@@ -12,7 +12,6 @@ The full list of modules described in this chapter is:
 
 .. toctree::
 
-   imp.rst
    zipimport.rst
    pkgutil.rst
    modulefinder.rst
diff --git a/Doc/library/superseded.rst b/Doc/library/superseded.rst
new file mode 100644
index 0000000..50a5983
--- /dev/null
+++ b/Doc/library/superseded.rst
@@ -0,0 +1,14 @@
+.. _superseded:
+
+******************
+Superseded Modules
+******************
+
+The modules described in this chapter are deprecated and only kept for
+backwards compatibility. They have been superseded by other modules.
+
+
+.. toctree::
+
+   optparse.rst
+   imp.rst