* dbus.texi (Asynchronous Methods): Allow nil handler.

2 files changed, 13 insertions, 8 deletions

diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 6722fbd4705..a6b601ce0a3 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,9 +1,13 @@
+2009-08-16  Michael Albinus  <michael.albinus@gmx.de>
+
+        * dbus.texi (Asynchronous Methods): Allow nil handler.
+
 2009-08-15  Michael Kifer  <kifer@cs.stonybrook.edu>
-        
+
         * ediff.texi (ediff-current-file): added information about this new function.
-        
+
         * viper.text: Added information about C-s in viper's search command.
-        
+
 2009-08-09  Colin Williams  <lackita@gmail.com>  (tiny change)
 
         * calc.texi (Date Forms): Fix typos.
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index 3eb0076649d..1c9c66103eb 100644
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -1189,7 +1189,8 @@ D-Bus object path, @var{service} is registered at.  @var{interface} is
 an interface offered by @var{service}.  It must provide @var{method}.
 
 @var{handler} is a Lisp function, which is called when the
-corresponding return message has arrived.
+corresponding return message has arrived.  If @var{handler} is
+@code{nil}, no return message will be expected.
 
 If the parameter @code{:timeout} is given, the following integer
 @var{timeout} specifies the maximum number of milliseconds a reply
@@ -1201,10 +1202,10 @@ All other arguments args are passed to @var{method} as arguments.
 They are converted into D-Bus types as described in @ref{Type
 Conversion}.
 
-The function returns a key into the hash table
-@code{dbus-registered-functions-table}.  The corresponding entry in
-the hash table is removed, when the return message has been arrived,
-and @var{handler} is called.  Example:
+Unless @var{handler} is @code{nil}, the function returns a key into
+the hash table @code{dbus-registered-functions-table}.  The
+corresponding entry in the hash table is removed, when the return
+message has been arrived, and @var{handler} is called.  Example:
 
 @lisp
 (dbus-call-method-asynchronously