Move getopt back to the superseded section

python · ncoghlan · Dec 23, 2024 · Oct 31, 2024 · Oct 31, 2024 · Oct 31, 2024
commit 4e50c74ba908c12f36b0e4ce78e21b72fb57b3fe
diff --git a/Doc/library/cmdlinelibs.rst b/Doc/library/cmdlinelibs.rst
@@ -14,7 +14,6 @@ Here's an overview:
 
    argparse.rst
    optparse.rst
-   getopt.rst
    getpass.rst
    fileinput.rst
    curses.rst

diff --git a/Doc/library/superseded.rst b/Doc/library/superseded.rst
@@ -4,8 +4,20 @@
 Superseded Modules
 ******************
 
-The modules described in this chapter are deprecated or :term:`soft deprecated` and only kept for
-backwards compatibility. They have been superseded by other modules.
+The modules described in this chapter have been superseded by other modules
+for most use cases, and are retained primarily to preserve backwards compatibility.
 
-With the removal of various obsolete modules through :pep:`594`, there are currently no modules
-in this category.
+Modules may appear in this chapter because they only cover a limited subset of
+a problem space, and a more generally applicable solution is available elsewhere
+in the standard library (for example, :mod:`getopt`).
+
+Alternatively, modules may appear in this chapter because they are deprecated
+outright, and awaiting removal in a future release, or they are
+:term:`soft deprecated` and their use is actively discouraged in new projects.
+With the removal of various obsolete modules through :pep:`594`, there are
+currently no modules in this latter category.
+
+.. toctree::
+   :maxdepth: 1
+
+   getopt.rst