From: Terry Jan Reedy <tjreedy@udel.edu>
Date: Sun, 18 Aug 2013 22:22:43 +0000 (-0400)
Subject: Issue #18592: Add docstrings to file being tested (idlelib.SearchDialogBase.py).
X-Git-Tag: v3.4.0a2~190^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c5507c0d76b3a9c6ec3fbfdabd9e5030bda283be;p=thirdparty%2FPython%2Fcpython.git

Issue #18592: Add docstrings to file being tested (idlelib.SearchDialogBase.py).
---

diff --git a/Lib/idlelib/SearchDialogBase.py b/Lib/idlelib/SearchDialogBase.py
index 65914ac24ec2..872c7c2b8a74 100644
--- 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"