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 :-)
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.
Patch to bind.n r1.7
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 :-)
Updated patch, more info on the meaning of %-substitutions
Logged In: YES
user_id=68433
Patch committed: bind.n r1.8