comparison doc/misc/dbus.texi @ 100008:caa9c8dbbeb0

(Receiving Method Calls): Clean up previous change.
author Richard M. Stallman <rms@gnu.org>
date Fri, 28 Nov 2008 14:47:54 +0000
parents cd82ae256e46
children cb5d2387102c
comparison
equal deleted inserted replaced
100007:e99a24e60b05 100008:caa9c8dbbeb0
1252 registered. 1252 registered.
1253 1253
1254 @var{interface} is the interface offered by @var{service}. It must 1254 @var{interface} is the interface offered by @var{service}. It must
1255 provide @var{method}. 1255 provide @var{method}.
1256 1256
1257 @var{handler} is a Lisp function to be called when when a @var{method} 1257 @var{handler} is a Lisp function to be called when a @var{method} call
1258 call is is received. It must accept as arguments the input arguments 1258 is received. It must accept as arguments the input arguments of
1259 of @var{method}. @var{handler} must return a list, which elements are 1259 @var{method}. @var{handler} should return a list, whose elements are
1260 used as arguments for the reply message of @var{method}. This list 1260 to be used as arguments for the reply message of @var{method}. This
1261 can be composed like the input parameters in @ref{Type Conversion}. 1261 list can be composed like the input parameters in @ref{Type
1262 If only one Lisp object is returned, and this object is not a consp, 1262 Conversion}.
1263 then @var{handler} can return this object directly, instead of of list 1263
1264 of this object. 1264 If @var{handler} wants to return just one Lisp object and it is not a
1265 cons cell, @var{handler} can return this object directly, instead of
1266 returning a list containing the object.
1265 1267
1266 The default D-Bus timeout when waiting for a message reply is 25 1268 The default D-Bus timeout when waiting for a message reply is 25
1267 seconds. This value could be even smaller, depending on the calling 1269 seconds. This value could be even smaller, depending on the calling
1268 client. Therefore, @var{handler} shall not last longer than 1270 client. Therefore, @var{handler} shall not last longer than
1269 absolutely necessary. 1271 absolutely necessary.