changeset:   98253:2f6aa20c05b3
branch:      2.7
parent:      98249:8b3dc527a62c
user:        Terry Jan Reedy <tjreedy@udel.edu>
date:        Thu Sep 24 23:13:43 2015 -0400
files:       Doc/library/idle.rst
description:
Issue #25225: Condense and rewrite Idle doc section on text colors.


diff -r 8b3dc527a62c -r 2f6aa20c05b3 Doc/library/idle.rst
--- a/Doc/library/idle.rst	Thu Sep 24 17:31:54 2015 -0400
+++ b/Doc/library/idle.rst	Thu Sep 24 23:13:43 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