Issue #7061: Dropped "for Tk" from turtle module title and moved its

doc section under frameworks.  Also fixed a couple of markup issues
that affected TOC rendering.

7 files changed, 10 insertions, 14 deletions

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 5e2336f235..66b29e0946 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -1,7 +1,5 @@
-.. _ast:
-
-Abstract Syntax Trees
-=====================
+:mod:`ast` --- Abstract Syntax Trees
+====================================
 
 .. module:: ast
    :synopsis: Abstract Syntax Tree classes and manipulation.
diff --git a/Doc/library/cmd.rst b/Doc/library/cmd.rst
index d713b8f6dc..d0332aaf8f 100644
--- a/Doc/library/cmd.rst
+++ b/Doc/library/cmd.rst
@@ -204,7 +204,7 @@ Instances of :class:`Cmd` subclasses have some public instance variables:
    support :program:`Emacs`\ -like line editing  and command-history keystrokes.)
 
 Cmd Example
-===========
+-----------
 
 .. sectionauthor:: Raymond Hettinger <python at rcn dot com>
 
diff --git a/Doc/library/frameworks.rst b/Doc/library/frameworks.rst
index fe632e011b..15ceeec9c2 100644
--- a/Doc/library/frameworks.rst
+++ b/Doc/library/frameworks.rst
@@ -13,5 +13,6 @@ The full list of modules described in this chapter is:
 
 .. toctree::
 
+   turtle.rst
    cmd.rst
    shlex.rst
diff --git a/Doc/library/pdb.rst b/Doc/library/pdb.rst
index d613e0b171..cab4569f4f 100644
--- a/Doc/library/pdb.rst
+++ b/Doc/library/pdb.rst
@@ -1,5 +1,3 @@
-.. _debugger:
-
 :mod:`pdb` --- The Python Debugger
 ==================================
 
@@ -164,7 +162,7 @@ access further features, you have to do this yourself:
 .. _debugger-commands:
 
 Debugger Commands
-=================
+-----------------
 
 The commands recognized by the debugger are listed below.  Most commands can be
 abbreviated to one or two letters as indicated; e.g. ``h(elp)`` means that
diff --git a/Doc/library/sys.rst b/Doc/library/sys.rst
index bf8e0d0164..01dad9c2f1 100644
--- a/Doc/library/sys.rst
+++ b/Doc/library/sys.rst
@@ -572,7 +572,7 @@ always available.
    Their intended use is to allow an interactive user to import a debugger module
    and engage in post-mortem debugging without having to re-execute the command
    that caused the error.  (Typical use is ``import pdb; pdb.pm()`` to enter the
-   post-mortem debugger; see chapter :ref:`debugger` for
+   post-mortem debugger; see :mod:`pdb` module for
    more information.)
 
    The meaning of the variables is the same as that of the return values from
diff --git a/Doc/library/tk.rst b/Doc/library/tk.rst
index 9cac407de8..95cd1c7712 100644
--- a/Doc/library/tk.rst
+++ b/Doc/library/tk.rst
@@ -36,7 +36,6 @@ alternatives, see the :ref:`other-gui-packages` section.
    tkinter.ttk.rst
    tkinter.tix.rst
    tkinter.scrolledtext.rst
-   turtle.rst
    idle.rst
    othergui.rst
 
diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst
index 2e803bd911..08fb7a8e0c 100644
--- a/Doc/library/turtle.rst
+++ b/Doc/library/turtle.rst
@@ -1,9 +1,9 @@
-========================================
-:mod:`turtle` --- Turtle graphics for Tk
-========================================
+=================================
+:mod:`turtle` --- Turtle graphics
+=================================
 
 .. module:: turtle
-   :synopsis: Turtle graphics for Tk
+   :synopsis: An educational framework for simple graphics applications
 .. sectionauthor:: Gregor Lingl <gregor.lingl@aon.at>
 
 .. testsetup:: default