From: Terry Jan Reedy <tjreedy@udel.edu>
Date: Fri, 25 Sep 2015 03:13:43 +0000 (-0400)
Subject: Issue #25225: Condense and rewrite Idle doc section on text colors.
X-Git-Tag: v2.7.11rc1~117
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f56f8d1800d41aa5ea632bad38f2b7b9d0c659f9;p=thirdparty%2FPython%2Fcpython.git

Issue #25225: Condense and rewrite Idle doc section on text colors.
---

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index fe8e89ed0ecc..0634e540298c 100644
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -458,38 +458,20 @@ Python Shell window
   * :kbd:`Return` while on any previous command retrieves that command
 
 
-Syntax colors
--------------
-
-The coloring is applied in a background "thread," so you may occasionally see
-uncolorized text.  To change the color scheme, edit the ``[Colors]`` section in
-:file:`config.txt`.
-
-Python syntax colors:
-   Keywords
-      orange
-
-   Strings
-      green
-
-   Comments
-      red
-
-   Definitions
-      blue
-
-Shell colors:
-   Console output
-      brown
-
-   stdout
-      blue
-
-   stderr
-      dark green
+Text colors
+^^^^^^^^^^^
 
-   stdin
-      black
+Idle defaults to black on white text, but colors text with special meanings.
+For the shell, these are shell output, shell error, user output, and
+user error.  For Python code, at the shell prompt or in an editor, these are
+keywords, builtin class and function names, names following ``class`` and
+``def``, strings, and comments. For any text window, these are the cursor (when
+present), found text (when possible), and selected text.
+
+Text coloring is done in the background, so uncolorized text is occasionally
+visible.  To change the color scheme, use the Configure IDLE dialog
+Highlighting tab.  The marking of debugger breakpoint lines in the editor and
+text in popups and dialogs is not user-configurable.
 
 
 Startup and code execution