Mercurial > hg > xemacs-beta

comparison man/lispref/tooltalk.texi @ 5791:9fae6227ede5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Silence texinfo 5.2 warnings, primarily by adding next, prev, and up pointers to all nodes. See xemacs-patches message with ID <5315f7bf.sHpFD7lXYR05GH6E%james@xemacs.org>.
author Jerry James <james@xemacs.org>
date Thu, 27 Mar 2014 08:59:03 -0600
parents 576fb035e263
children
comparison
equal deleted inserted replaced
5790:dcf9067f26bb 5791:9fae6227ede5
1 @c -*-texinfo-*- 1 @c -*-texinfo-*-
2 @c This is part of the XEmacs Lisp Reference Manual. 2 @c This is part of the XEmacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc. 3 @c Copyright (C) 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
4 @c See the file lispref.texi for copying conditions. 4 @c See the file lispref.texi for copying conditions.
5 @setfilename ../../info/tooltalk.info 5 @setfilename ../../info/tooltalk.info
6 @node ToolTalk Support, LDAP Support, X-Windows, top 6 @node ToolTalk Support, LDAP Support, X-Windows, Top
7 @chapter ToolTalk Support 7 @chapter ToolTalk Support
8 @cindex ToolTalk 8 @cindex ToolTalk
9 9
10 @menu 10 @menu
11 * XEmacs ToolTalk API Summary:: 11 * XEmacs ToolTalk API Summary::
12 * Sending Messages:: 12 * Sending Messages::
13 * Receiving Messages:: 13 * Receiving Messages::
14 @end menu 14 @end menu
15 15
16 @node XEmacs ToolTalk API Summary 16 @node XEmacs ToolTalk API Summary, Sending Messages, ToolTalk Support, ToolTalk Support
17 @section XEmacs ToolTalk API Summary 17 @section XEmacs ToolTalk API Summary
18 18
19 The XEmacs Lisp interface to ToolTalk is similar, at least in spirit, 19 The XEmacs Lisp interface to ToolTalk is similar, at least in spirit,
20 to the standard C ToolTalk API. Only the message and pattern parts 20 to the standard C ToolTalk API. Only the message and pattern parts
21 of the API are supported at present; more of the API could be added 21 of the API are supported at present; more of the API could be added
45 Anywhere a ToolTalk enum constant, e.g. @samp{TT_SESSION}, is valid, one 45 Anywhere a ToolTalk enum constant, e.g. @samp{TT_SESSION}, is valid, one
46 can substitute the corresponding symbol, e.g. @code{'TT_SESSION}. This 46 can substitute the corresponding symbol, e.g. @code{'TT_SESSION}. This
47 simplifies building lists that represent messages and patterns. 47 simplifies building lists that represent messages and patterns.
48 @end itemize 48 @end itemize
49 49
50 @node Sending Messages 50 @node Sending Messages, Receiving Messages, XEmacs ToolTalk API Summary, ToolTalk Support
51 @section Sending Messages 51 @section Sending Messages
52 @cindex sending ToolTalk messages 52 @cindex sending ToolTalk messages
53 @cindex ToolTalk message 53 @cindex ToolTalk message
54 54
55 @menu 55 @menu
56 * Example of Sending Messages:: 56 * Example of Sending Messages::
57 * Elisp Interface for Sending Messages:: 57 * Elisp Interface for Sending Messages::
58 @end menu 58 @end menu
59 59
60 @node Example of Sending Messages 60 @node Example of Sending Messages, Elisp Interface for Sending Messages, Sending Messages, Sending Messages
61 @subsection Example of Sending Messages 61 @subsection Example of Sending Messages
62 62
63 Here's a simple example that sends a query to another application 63 Here's a simple example that sends a query to another application
64 and then displays its reply. Both the query and the reply are 64 and then displays its reply. Both the query and the reply are
65 stored in the first argument of the message. 65 stored in the first argument of the message.
83 83
84 (let ((m (make-tooltalk-message random-query-message))) 84 (let ((m (make-tooltalk-message random-query-message)))
85 (send-tooltalk-message m)) 85 (send-tooltalk-message m))
86 @end example 86 @end example
87 87
88 @node Elisp Interface for Sending Messages 88 @node Elisp Interface for Sending Messages, , Example of Sending Messages, Sending Messages
89 @subsection Elisp Interface for Sending Messages 89 @subsection Elisp Interface for Sending Messages
90 90
91 @defun make-tooltalk-message attributes 91 @defun make-tooltalk-message attributes
92 Create a ToolTalk message and initialize its attributes. 92 Create a ToolTalk message and initialize its attributes.
93 The value of @var{attributes} must be a list of alternating keyword/values, 93 The value of @var{attributes} must be a list of alternating keyword/values,
240 Apply @samp{tt_message_destroy} to the message. It's not necessary to 240 Apply @samp{tt_message_destroy} to the message. It's not necessary to
241 destroy messages after they've been processed by a message or pattern 241 destroy messages after they've been processed by a message or pattern
242 callback, the Lisp/ToolTalk callback machinery does this for you. 242 callback, the Lisp/ToolTalk callback machinery does this for you.
243 @end defun 243 @end defun
244 244
245 @node Receiving Messages 245 @node Receiving Messages, , Sending Messages, ToolTalk Support
246 @section Receiving Messages 246 @section Receiving Messages
247 @cindex ToolTalk pattern 247 @cindex ToolTalk pattern
248 @cindex receiving ToolTalk messages 248 @cindex receiving ToolTalk messages
249 249
250 @menu 250 @menu
251 * Example of Receiving Messages:: 251 * Example of Receiving Messages::
252 * Elisp Interface for Receiving Messages:: 252 * Elisp Interface for Receiving Messages::
253 @end menu 253 @end menu
254 254
255 @node Example of Receiving Messages 255 @node Example of Receiving Messages, Elisp Interface for Receiving Messages, Receiving Messages, Receiving Messages
256 @subsection Example of Receiving Messages 256 @subsection Example of Receiving Messages
257 257
258 Here's a simple example of a handler for a message that tells XEmacs to 258 Here's a simple example of a handler for a message that tells XEmacs to
259 display a string in the mini-buffer area. The message operation is 259 display a string in the mini-buffer area. The message operation is
260 called @samp{emacs-display-string}. Its first (0th) argument is the 260 called @samp{emacs-display-string}. Its first (0th) argument is the
272 272
273 (let ((p (make-tooltalk-pattern display-string-pattern))) 273 (let ((p (make-tooltalk-pattern display-string-pattern)))
274 (register-tooltalk-pattern p)) 274 (register-tooltalk-pattern p))
275 @end example 275 @end example
276 276
277 @node Elisp Interface for Receiving Messages 277 @node Elisp Interface for Receiving Messages, , Example of Receiving Messages, Receiving Messages
278 @subsection Elisp Interface for Receiving Messages 278 @subsection Elisp Interface for Receiving Messages
279 279
280 @defun make-tooltalk-pattern attributes 280 @defun make-tooltalk-pattern attributes
281 Create a ToolTalk pattern and initialize its attributes. 281 Create a ToolTalk pattern and initialize its attributes.
282 The value of attributes must be a list of alternating keyword/values, 282 The value of attributes must be a list of alternating keyword/values,