Tk Source Code

View Ticket
Login
Ticket UUID: 523593
Title: bind(n) manpage needs more detail
Type: RFE Version: None
Submitter: jenglish Created on: 2002-02-27 21:04:03
Subsystem: 69. Events Assigned To: jenglish
Priority: 2 Severity:
Status: Closed Last Modified: 2003-08-20 02:43:19
Resolution: Fixed Closed By: jenglish
    Closed on: 2003-08-19 19:43:19
Description:
On comp.lang.tcl, Donal Fellows wrote:
--
The [bind] manpage really assumes a deep knowledge of
X, and there are many of
its mysteries that I am still a long way from
penetrating (all the Focus related
stuff is particularly gnostic...)  Documentation
improvements (particularly ones
that state when an event might be generated by the
system) would be gladly
accepted...
--

In particular, bind(n) states:

     Most of the above events have the same fields 
and  behaviors 
     as  events  in the X Windowing system.  You can
find
     more detailed descriptions of these events in any
X window
     programming  book.

This section should be replaced with an actual detailed
description,
for the benefit of those who don't want to buy a book
on X :-)
User Comments: jenglish added on 2003-08-20 02:43:19:
Logged In: YES 
user_id=68433

Patch committed: bind.n r1.8

jenglish added on 2003-08-07 04:25:59:

File Added - 58034: bind.n.patch

Logged In: YES 
user_id=68433

As suggested, more information on the meaning of the various
%- substitutions is also needed.  Revised patch adds some.

No guarantees concerning accuracy or completeness :-)

jenglish added on 2003-08-07 03:01:21:

File Added - 58023: bind.n.patch

jenglish added on 2003-08-07 03:01:20:
Logged In: YES 
user_id=68433

OK, a year and a half later, I've finally gotten around to
this.  See attached patch; preformatted version at <URL:
http://tmml.sourceforge.net/doc/tk/bind.html > (see section
"EVENT TYPES").

I couldn't figure out how to explain the %d (detail) field
for FocusIn/FocusOut/Enter/Leave evnts in fewer than six
paragraphs, so I just gave up on it, saying only that
"<FocusIn>" indicates that the target window or one of its
descendants has the focus, and "<FocusOut>" means the focus
has left the hierarchy.

Attachments: