[New-bugs-announce] [issue3005] EasyDialogs - documentation enhancement

kee nethery report at bugs.python.org
Thu May 29 20:43:46 CEST 2008


New submission from kee nethery <kee at kagi.com>:

issue: We spent quite a bit of time trying to figure out why EasyDialogs 
was not working, no dialogs were appearing. Eventually I had to check an 
AIM and noticed several icons bouncing in the dock. Scrolled over one 
and it claimed it was Python, and when selected, displayed the dialog we 
had been trying to get to appear. A simple sentence explaining how to 
make the dialog appear would be a useful addition to the documentation. 
URL for the docs shown below. Existing intro paragraph shown below. 
Suggested additional sentence shown below.

url: http://docs.python.org/mac/module-EasyDialogs.html

existing: The EasyDialogs module contains some simple dialogs for the 
Macintosh. All routines take an optional resource ID parameter id with 
which one can override the DLOG resource used for the dialog, provided 
that the dialog items correspond (both type and item number) to those in 
the default DLOG resource. See source code for details.

suggested: The EasyDialogs module contains some simple dialogs for the 
Macintosh. The dialogs get launched in a separate application which 
appears in the dock and must be clicked on for the dialogs be displayed. 
All routines take an optional resource ID parameter id with which one 
can override the DLOG resource used for the dialog, provided that the 
dialog items correspond (both type and item number) to those in the 
default DLOG resource. See source code for details.

Thanks, kee nethery

----------
assignee: georg.brandl
components: Documentation
messages: 67507
nosy: georg.brandl, keenethery
severity: normal
status: open
title: EasyDialogs - documentation enhancement
type: feature request
versions: Python 2.5

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue3005>
_______________________________________


More information about the New-bugs-announce mailing list