From 242ce3651c3918971461af2b30e913cef0890bca Mon Sep 17 00:00:00 2001 From: dkf Date: Mon, 10 Dec 2007 21:37:19 +0000 Subject: Clarify docs to note that [event info] isn't clairvoyant. --- ChangeLog | 21 ++++++++++++++------- doc/event.n | 7 ++++++- 2 files changed, 20 insertions(+), 8 deletions(-) diff --git a/ChangeLog b/ChangeLog index 63fda0c..d4d1a14 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,19 +1,26 @@ +2007-12-10 Donal K. Fellows + + * doc/event.n: Clarify the fact that [event info] only returns the + names of virtual events that are bound to physical event sequences. + This follows on from comments on comp.lang.tcl. + http://groups.google.com/group/comp.lang.tcl/msg/935d2d226ae8a770 + 2007-12-10 Joe English * doc/AddOption.3, doc/CrtImgType.3, doc/CrtPhImgFmt.3, - doc/InternAtom.3, doc/TextLayout.3, doc/chooseColor.n, - doc/chooseDirectory.n, doc/loadTk.n, doc/palette.n, - doc/ttk_combobox.n: Various markup fixes (mostly: missing - quotes on .SH arguments, extraneous .PPs) + * doc/InternAtom.3, doc/TextLayout.3, doc/chooseColor.n, + * doc/chooseDirectory.n, doc/loadTk.n, doc/palette.n, + * doc/ttk_combobox.n: Various markup fixes (mostly: missing quotes on + .SH arguments, extraneous .PPs) - * doc/ttk_entry.n, doc/ttk_scrollbar.n, doc/ttk_treeview.n: - Remove extra .BEs that got added by mistake somewhere. + * doc/ttk_entry.n, doc/ttk_scrollbar.n, doc/ttk_treeview.n: Remove + extra .BEs that got added by mistake somewhere. 2007-12-10 Daniel Steffen * generic/tk.decls: use new genstubs 'export' command to * generic/tkInt.decls: mark exported symbols not in stubs - table [FR 1716117]; cleanup formatting. + table [FR 1716117]; cleanup formatting * generic/tkIntDecls.h: regen with new genStubs.tcl. * generic/tkIntPlatDecls.h: [Tcl Bug 1834288] diff --git a/doc/event.n b/doc/event.n index ccf1d68..c0187ae 100644 --- a/doc/event.n +++ b/doc/event.n @@ -5,7 +5,7 @@ '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. '\" -'\" RCS: @(#) $Id: event.n,v 1.17 2007/11/01 23:03:54 dkf Exp $ +'\" RCS: @(#) $Id: event.n,v 1.18 2007/12/10 21:37:19 dkf Exp $ '\" .so man.macros .TH event n 8.3 Tk "Tk Built-In Commands" @@ -76,6 +76,11 @@ If \fB<<\fIvirtual\fB>>\fR is specified then the return value is a list whose elements are the physical event sequences currently defined for the given virtual event; if the virtual event is not defined then an empty string is returned. +.RS +.PP +Note that virtual events that that are not bound to physical event +sequences are \fInot\fR returned by \fBevent info\fR. +.RE .SH "EVENT FIELDS" .PP The following options are supported for the \fBevent generate\fR -- cgit v0.12