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

Terry Reedy tjreedy at udel.edu
Tue Aug 20 21:30:12 CEST 2013


On 8/20/2013 11:58 AM, Ezio Melotti wrote:

> On Mon, Aug 19, 2013 at 1:29 AM, terry.reedy <python-checkins at python.org
>        Issue #18592: Add docstrings to file being tested
>     (idlelib.SearchDialogBase.py <http://idlelib.SearchDialogBase.py>).

>       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);

This is wrong -- these are Checkbuttons

>     +    a row of dialog specific radiobuttons (create_other_buttons).

dialog-specific Radiobuttons

> Should this be "radio buttons"?

I specifically meant instances of tkinter.Radiobutton. When a 
capitalized class name is also an English noun (Decimal, Fraction) we 
can get away with upper-casing or not when referring to instances. Do we 
have a style rule from when the class names are not? I added a note to 
the issue for the next edit.



More information about the Python-checkins mailing list