gh-137777: Disband the 'Program Frameworks' chapter (#137796)

diff --git a/Doc/library/cmdlinelibs.rst b/Doc/library/cmdlinelibs.rst
index 085d31af7bca1ff2ea255c0823dfb979419476a4..32f8c2c9f4ae3262a8a6ad6ff93a94c32c279744 100644 (file)
--- a/Doc/library/cmdlinelibs.rst
+++ b/Doc/library/cmdlinelibs.rst
@@ -1,7 +1,7 @@
 .. _cmdlinelibs:
 
 ********************************
-Command Line Interface Libraries
+Command-line interface libraries
 ********************************
 
 The modules described in this chapter assist with implementing
@@ -19,3 +19,4 @@ Here's an overview:
    curses.rst
    curses.ascii.rst
    curses.panel.rst
+   cmd.rst

diff --git a/Doc/library/frameworks.rst b/Doc/library/frameworks.rst
index 15ceeec9c255edb1854119ce96ee23dcd4b1110c..f8e2f6bb18cb1cb5648037bb0b9bcda9a843ebc2 100644 (file)
--- a/Doc/library/frameworks.rst
+++ b/Doc/library/frameworks.rst
@@ -1,18 +1,13 @@
+:orphan:
+
 .. _frameworks:
 
 ******************
-Program Frameworks
+Program frameworks
 ******************
 
-The modules described in this chapter are frameworks that will largely dictate
-the structure of your program.  Currently the modules described  here are all
-oriented toward writing command-line interfaces.
-
-The full list of modules described in this chapter is:
-
-
-.. toctree::
+This chapter is no longer maintained, and the modules it contained have been moved to their respective topical documentation.
 
-   turtle.rst
-   cmd.rst
-   shlex.rst
+* :mod:`cmd` — :doc:`Command Line Interface Libraries <./cmdlinelibs>`
+* :mod:`shlex` — :doc:`Unix Specific Services <./unix>`
+* :mod:`turtle` — :doc:`Graphical User Interfaces with Tk <./tk>`

diff --git a/Doc/library/index.rst b/Doc/library/index.rst
index 44b218948d07e1ace3ff9a3aec10f96a98b47d9a..163e1679c65ef83614385a49b8269665f8a32c03 100644 (file)
--- a/Doc/library/index.rst
+++ b/Doc/library/index.rst
@@ -63,7 +63,6 @@ the `Python Package Index <https://pypi.org>`_.
    internet.rst
    mm.rst
    i18n.rst
-   frameworks.rst
    tk.rst
    development.rst
    debug.rst

diff --git a/Doc/library/tk.rst b/Doc/library/tk.rst
index 0593f8b73ea545629d09668f36db3f0aa57843ce..fa3c7e910ce21f0779589805a8c1b6142678b40d 100644 (file)
--- a/Doc/library/tk.rst
+++ b/Doc/library/tk.rst
@@ -1,7 +1,7 @@
 .. _tkinter:
 
 *********************************
-Graphical User Interfaces with Tk
+Graphical user interfaces with Tk
 *********************************
 
 .. index::
@@ -39,6 +39,7 @@ alternative `GUI frameworks and tools <https://wiki.python.org/moin/GuiProgrammi
    tkinter.dnd.rst
    tkinter.ttk.rst
    idle.rst
+   turtle.rst
 
 .. Other sections I have in mind are
    Tkinter internals

diff --git a/Doc/library/unix.rst b/Doc/library/unix.rst
index 4553a104d15a24d16921b856f2ae368e076e28ff..bae32b362803f12cca4fd262c0adf5efcb5d6ffa 100644 (file)
--- a/Doc/library/unix.rst
+++ b/Doc/library/unix.rst
@@ -1,7 +1,7 @@
 .. _unix:
 
 **********************
-Unix Specific Services
+Unix-specific services
 **********************
 
 The modules described in this chapter provide interfaces to features that are
@@ -11,6 +11,7 @@ of it.  Here's an overview:
 
 .. toctree::
 
+   shlex.rst
    posix.rst
    pwd.rst
    grp.rst