Mercurial > emacs
comparison doc/misc/dbus.texi @ 104307:562b1d80843b
* dbus.texi (Asynchronous Methods): Allow nil handler.
| author | Michael Albinus <michael.albinus@gmx.de> |
|---|---|
| date | Sun, 16 Aug 2009 17:48:45 +0000 |
| parents | 5baa98667482 |
| children | 8e031ee168ec |
comparison
equal
deleted
inserted
replaced
| 104306:69b67a46e5b2 | 104307:562b1d80843b |
|---|---|
| 1187 @var{service} is the D-Bus service name to be used. @var{path} is the | 1187 @var{service} is the D-Bus service name to be used. @var{path} is the |
| 1188 D-Bus object path, @var{service} is registered at. @var{interface} is | 1188 D-Bus object path, @var{service} is registered at. @var{interface} is |
| 1189 an interface offered by @var{service}. It must provide @var{method}. | 1189 an interface offered by @var{service}. It must provide @var{method}. |
| 1190 | 1190 |
| 1191 @var{handler} is a Lisp function, which is called when the | 1191 @var{handler} is a Lisp function, which is called when the |
| 1192 corresponding return message has arrived. | 1192 corresponding return message has arrived. If @var{handler} is |
| 1193 @code{nil}, no return message will be expected. | |
| 1193 | 1194 |
| 1194 If the parameter @code{:timeout} is given, the following integer | 1195 If the parameter @code{:timeout} is given, the following integer |
| 1195 @var{timeout} specifies the maximum number of milliseconds a reply | 1196 @var{timeout} specifies the maximum number of milliseconds a reply |
| 1196 message must arrive. The default value is 25.000. If there is no | 1197 message must arrive. The default value is 25.000. If there is no |
| 1197 reply message in time, a D-Bus error is raised (@pxref{Errors and | 1198 reply message in time, a D-Bus error is raised (@pxref{Errors and |
| 1199 | 1200 |
| 1200 All other arguments args are passed to @var{method} as arguments. | 1201 All other arguments args are passed to @var{method} as arguments. |
| 1201 They are converted into D-Bus types as described in @ref{Type | 1202 They are converted into D-Bus types as described in @ref{Type |
| 1202 Conversion}. | 1203 Conversion}. |
| 1203 | 1204 |
| 1204 The function returns a key into the hash table | 1205 Unless @var{handler} is @code{nil}, the function returns a key into |
| 1205 @code{dbus-registered-functions-table}. The corresponding entry in | 1206 the hash table @code{dbus-registered-functions-table}. The |
| 1206 the hash table is removed, when the return message has been arrived, | 1207 corresponding entry in the hash table is removed, when the return |
| 1207 and @var{handler} is called. Example: | 1208 message has been arrived, and @var{handler} is called. Example: |
| 1208 | 1209 |
| 1209 @lisp | 1210 @lisp |
| 1210 (dbus-call-method-asynchronously | 1211 (dbus-call-method-asynchronously |
| 1211 :system "org.freedesktop.Hal" | 1212 :system "org.freedesktop.Hal" |
| 1212 "/org/freedesktop/Hal/devices/computer" | 1213 "/org/freedesktop/Hal/devices/computer" |