changeset:   98254:f5502ff7ae2d
branch:      3.4
parent:      98250:1d0f4b94066b
user:        Terry Jan Reedy <tjreedy@udel.edu>
date:        Thu Sep 24 23:13:49 2015 -0400
files:       Doc/library/idle.rst
description:
Issue #25225: Condense and rewrite Idle doc section on text colors.


diff -r 1d0f4b94066b -r f5502ff7ae2d Doc/library/idle.rst
--- a/Doc/library/idle.rst	Thu Sep 24 17:32:01 2015 -0400
+++ b/Doc/library/idle.rst	Thu Sep 24 23:13:49 2015 -0400
@@ -458,38 +458,20 @@
   * :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
+Text colors
+^^^^^^^^^^^
 
-   Comments
-      red
-
-   Definitions
-      blue
+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.
 
-Shell colors:
-   Console output
-      brown
-
-   stdout
-      blue
-
-   stderr
-      dark green
-
-   stdin
-      black
+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