From 4638c5b7f351da1156a5f365646935510b67d97a Mon Sep 17 00:00:00 2001
From: Barry Warsaw <barry@python.org>
Date: Fri, 2 Oct 1998 16:20:14 +0000
Subject: [PATCH] Docstring

---
 Tools/pynche/StripViewer.py | 26 ++++++++++++++++++++++++++
 Tools/pynche/Switchboard.py | 14 ++++++++++++++
 Tools/pynche/TextViewer.py  | 19 ++++++++++++++++++-
 3 files changed, 58 insertions(+), 1 deletion(-)

diff --git a/Tools/pynche/StripViewer.py b/Tools/pynche/StripViewer.py
index db825e32c3d..c6e2fbead11 100644
--- a/Tools/pynche/StripViewer.py
+++ b/Tools/pynche/StripViewer.py
@@ -1,3 +1,29 @@
+"""Strip viewer and related widgets.
+
+The classes in this file implement the StripViewer shown in the top two thirds 
+of the main Pynche window.  It consists of three StripWidgets which display
+the variations in red, green, and blue respectively of the currently selected
+r/g/b color value.
+
+Each StripWidget shows the color variations that are reachable by varying an
+axis of the currently selected color.  So for example, if the color is
+
+  (R,G,B)=(127,163,196)
+
+then the Red variations show colors from (0,163,196) to (255,163,196), the
+Green variations show colors from (127,0,196) to (127,255,196), and the Blue
+variations show colors from (127,163,0) to (127,163,255).
+
+The selected color is always visible in all three StripWidgets, and in fact
+each StripWidget highlights the selected color, and has an arrow pointing to
+the selected chip, which includes the value along that particular axis.
+
+Clicking on any chip in any StripWidget selects that color, and updates all
+arrows and other windows.  By toggling on Update while dragging, Pynche will
+select the color under the cursor while you drag it, but be forewarned that
+this can be slow.
+"""
+
 import string
 from Tkinter import *
 import ColorDB
diff --git a/Tools/pynche/Switchboard.py b/Tools/pynche/Switchboard.py
index aaf67abcb0c..503752e2dfe 100644
--- a/Tools/pynche/Switchboard.py
+++ b/Tools/pynche/Switchboard.py
@@ -1,3 +1,17 @@
+"""Switchboard class.
+
+This class is used to coordinate updates among all Viewers.  Every Viewer must
+conform to the following interface:
+
+    - it must include a method called update_yourself() which takes three
+      arguments; the red, green, and blue values of the selected color.
+
+    - When a Viewer selects a color and wishes to update all other Views, it
+      should call update_views() on the Switchboard object.  Not that the
+      Viewer typically does *not* update itself before calling update_views(), 
+      since this would cause it to get updated twice.
+"""
+
 class Switchboard:
     def __init__(self, colordb):
         self.__views = []
diff --git a/Tools/pynche/TextViewer.py b/Tools/pynche/TextViewer.py
index 9fdab078250..9e77a021d8c 100644
--- a/Tools/pynche/TextViewer.py
+++ b/Tools/pynche/TextViewer.py
@@ -1,3 +1,20 @@
+"""TextViewer class.
+
+The TextViewer allows you to see how the selected color would affect various
+characteristics of a Tk text widget.  This is an output viewer only.
+
+In the top part of the window is a standard text widget with some sample text
+in it.  You are free to edit this text in any way you want (TBD: allow you to
+change font characteristics).  If you want changes in other viewers to update
+text characteristics, turn on Track color changes.
+
+To select which characteristic tracks the change, select one of the radio
+buttons in the window below.  Text foreground and background affect the text
+in the window above.  The Selection is what you see when you click the middle
+button and drag it through some text.  The Insertion is the insertion cursor
+in the text window (which only has a background).
+"""
+
 import sys
 from Tkinter import *
 from pynche import __version__
@@ -30,7 +47,7 @@ textual displays.''')
         self.__trackp = BooleanVar()
         self.__trackp.set(0)
         self.__which = IntVar()
-        self.__which.set(4)
+        self.__which.set(0)
         #
         # track toggle
         self.__t = Checkbutton(root, text='Track color changes',