@c -*-texinfo-*-
@c This is part of the XEmacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
+@c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
@c See the file lispref.texi for copying conditions.
@setfilename ../../info/tooltalk.info
@node ToolTalk Support, LDAP Support, X-Windows, top
have a function binding).
@item
-The session attribute for messages and patterns is always
+The session attribute for messages and patterns is always
initialized to the default session.
@item
(message "Random query turns up nothing")))))
(defvar random-query-message
- '( class TT_REQUEST
- scope TT_SESSION
+ '( class TT_REQUEST
+ scope TT_SESSION
address TT_PROCEDURE
op "random-query"
args '((TT_INOUT "?" "string"))
@defun make-tooltalk-message attributes
Create a ToolTalk message and initialize its attributes.
-The value of @var{attributes} must be a list of alternating keyword/values,
-where keywords are symbols that name valid message attributes.
+The value of @var{attributes} must be a list of alternating keyword/values,
+where keywords are symbols that name valid message attributes.
For example:
@example
- (make-tooltalk-message
+ (make-tooltalk-message
'(class TT_NOTICE
scope TT_SESSION
address TT_PROCEDURE
@refill
@end defun
-@defun create-tooltalk-message
+@defun create-tooltalk-message &optional no-callback
Create a new ToolTalk message. The message's session attribute is
initialized to the default session. Other attributes can be initialized
with @code{set-tooltalk-message-attribute}.
@code{make-tooltalk-message} is the preferred way to create and
initialize a message.
+
+Optional arg @var{no-callback} says don't add a C-level callback at all.
+Normally don't do that; just don't specify the Lisp callback when
+calling @code{make-tooltalk-message}.
@refill
@end defun
@defun make-tooltalk-pattern attributes
Create a ToolTalk pattern and initialize its attributes.
-The value of attributes must be a list of alternating keyword/values,
+The value of attributes must be a list of alternating keyword/values,
where keywords are symbols that name valid pattern attributes
or lists of valid attributes. For example:
@example
- (make-tooltalk-pattern
+ (make-tooltalk-pattern
'(category TT_OBSERVE
scope TT_SESSION
op ("operation1" "operation2")
args ("arg1" 12345 (TT_INOUT "arg3" "string"))))
@end example
-Attribute names are the same as those supported by
+Attribute names are the same as those supported by
@code{add-tooltalk-pattern-attribute}, plus @code{'args}.
Values must always be strings, integers, or symbols that represent
@refill
@end defun
-@defun register-tooltalk-pattern pat
+@defun register-tooltalk-pattern pattern
XEmacs will begin receiving messages that match this pattern.
@end defun
-@defun unregister-tooltalk-pattern pat
+@defun unregister-tooltalk-pattern pattern
XEmacs will stop receiving messages that match this pattern.
@end defun
-@defun add-tooltalk-pattern-attribute value pat indicator
+@defun add-tooltalk-pattern-attribute value pattern indicator
Add one value to the indicated pattern attribute. The names of
attributes are the same as the ToolTalk accessors used to set them less
the @samp{tooltalk_pattern_} prefix and the @samp{_add} suffix. For
message.
@end defun
-@defun add-tooltalk-pattern-arg pat mode type value
+@defun add-tooltalk-pattern-arg pattern mode vtype &optional value
Add one fully-specified argument to a ToolTalk pattern. @var{mode} must
-be one of @code{TT_IN}, @code{TT_INOUT}, or @code{TT_OUT}. @var{type}
+be one of @code{TT_IN}, @code{TT_INOUT}, or @code{TT_OUT}. @var{vtype}
must be a string. @var{value} can be an integer, string or @code{nil}.
If @var{value} is an integer then an integer argument
(@samp{tt_pattern_iarg_add}) is added; otherwise a string argument is
be the default session.
@end defun
-@defun destroy-tooltalk-pattern pat
+@defun destroy-tooltalk-pattern pattern
Apply @samp{tt_pattern_destroy} to the pattern. This effectively
unregisters the pattern.
@end defun