[Python-checkins] cpython (2.7): Issue #18592: Add docstrings to file being tested (idlelib.SearchDialogBase.py).

[terry.reedy]

http://hg.python.org/cpython/rev/0d2b87ec9f2b
changeset:   85246:0d2b87ec9f2b
branch:      2.7
parent:      85243:72c7a4cd4f55
user:        Terry Jan Reedy <tjreedy at udel.edu>
date:        Sun Aug 18 18:22:34 2013 -0400
summary:
  Issue #18592: Add docstrings to file being tested (idlelib.SearchDialogBase.py).

files:
  Lib/idlelib/SearchDialogBase.py |  17 +++++++++++++++++
  1 files changed, 17 insertions(+), 0 deletions(-)


diff --git a/Lib/idlelib/SearchDialogBase.py b/Lib/idlelib/SearchDialogBase.py
--- a/Lib/idlelib/SearchDialogBase.py
+++ b/Lib/idlelib/SearchDialogBase.py
@@ -1,6 +1,23 @@
+'''Define SearchDialogBase used by Search, Replace, and Grep dialogs.'''
 from Tkinter import *
 
 class SearchDialogBase:
+    '''Create most of a modal search dialog (make_frame, create_widgets).
+
+    The wide left column contains:
+    1 or 2 text entry lines (create_entries, make_entry);
+    a row of standard radiobuttons (create_option_buttons);
+    a row of dialog specific radiobuttons (create_other_buttons).
+    
+    The narrow right column contains command buttons
+    (create_command_buttons, make_button).
+    These are bound to functions that execute the command.
+
+    Except for command buttons, this base class is not limited to
+    items common to all three subclasses.  Rather, it is the Find dialog
+    minus the "Find Next" command and its execution function.
+    The other dialogs override methods to replace and add widgets.
+    '''
 
     title = "Search Dialog"
     icon = "Search"

-- 
Repository URL: http://hg.python.org/cpython