summaryrefslogtreecommitdiffstats
path: root/doc/RestrictEv.3
diff options
context:
space:
mode:
authornijtmans <nijtmans>2010-05-11 12:12:49 (GMT)
committernijtmans <nijtmans>2010-05-11 12:12:49 (GMT)
commitede9fc2f74a2e9aa5084e18c93d903e81f0f3303 (patch)
tree1a71cc0e56c633acfe0fb2e4a5af9d1ea1bce8bd /doc/RestrictEv.3
parent44d12a1d5aa9b0103f0c3bea1ed81b59d4d383d1 (diff)
downloadtk-ede9fc2f74a2e9aa5084e18c93d903e81f0f3303.zip
tk-ede9fc2f74a2e9aa5084e18c93d903e81f0f3303.tar.gz
tk-ede9fc2f74a2e9aa5084e18c93d903e81f0f3303.tar.bz2
Consistent use of variable names in RestrictEvent
API documentation and implementation: Use 'prev' in stead of 'old', and 'arg' in stead of 'clientData' everywhere, just as in tkEvent.c.
Diffstat (limited to 'doc/RestrictEv.3')
-rw-r--r--doc/RestrictEv.316
1 files changed, 8 insertions, 8 deletions
diff --git a/doc/RestrictEv.3 b/doc/RestrictEv.3
index 03907a6..ad59124 100644
--- a/doc/RestrictEv.3
+++ b/doc/RestrictEv.3
@@ -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: RestrictEv.3,v 1.8 2008/06/30 22:57:02 dkf Exp $
+'\" RCS: @(#) $Id: RestrictEv.3,v 1.9 2010/05/11 12:12:50 nijtmans Exp $
'\"
.so man.macros
.TH Tk_RestrictEvents 3 "" Tk "Tk Library Procedures"
@@ -17,15 +17,15 @@ Tk_RestrictEvents \- filter and selectively delay X events
\fB#include <tk.h>\fR
.sp
Tk_RestrictProc *
-\fBTk_RestrictEvents\fR(\fIproc, clientData, prevClientDataPtr\fR)
+\fBTk_RestrictEvents\fR(\fIproc, arg, prevArgPtr\fR)
.SH ARGUMENTS
-.AS Tk_RestrictProc **prevClientDataPtr
+.AS Tk_RestrictProc **prevArgPtr
.AP Tk_RestrictProc *proc in
Predicate procedure to call to filter incoming X events.
NULL means do not restrict events at all.
-.AP ClientData clientData in
+.AP ClientData arg in
Arbitrary argument to pass to \fIproc\fR.
-.AP ClientData *prevClientDataPtr out
+.AP ClientData *prevArgPtr out
Pointer to place to save argument to previous restrict procedure.
.BE
.SH DESCRIPTION
@@ -42,10 +42,10 @@ is a procedure with arguments and result that match
the type \fBTk_RestrictProc\fR:
.CS
typedef Tk_RestrictAction \fBTk_RestrictProc\fR(
- ClientData \fIclientData\fR,
+ ClientData \fIarg\fR,
XEvent *\fIeventPtr\fR);
.CE
-The \fIclientData\fR argument is a copy of the \fIclientData\fR passed
+The \fIarg\fR argument is a copy of the \fIarg\fR passed
to \fBTk_RestrictEvents\fR; it may be used to provide \fIproc\fR with
information it needs to filter events. The \fIeventPtr\fR points to
an event under consideration. \fIProc\fR returns a restrict action
@@ -57,7 +57,7 @@ left on the event queue for later processing. If the return value is
\fBTK_DISCARD_EVENT\fR, then the event will be removed from the event
queue and discarded without being processed.
.PP
-\fBTk_RestrictEvents\fR uses its return value and \fIprevClientDataPtr\fR
+\fBTk_RestrictEvents\fR uses its return value and \fIprevArgPtr\fR
to return information about the current event restriction procedure
(a NULL return value means there are currently no restrictions).
These values may be used to restore the previous restriction state