[Emacs-diffs] Changes to emacs/doc/misc/dbus.texi,v

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       08/03/30 12:52:00

Index: dbus.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/dbus.texi,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -b -r1.16 -r1.17
--- dbus.texi   21 Mar 2008 20:46:47 -0000      1.16
+++ dbus.texi   30 Mar 2008 12:52:00 -0000      1.17
@@ -425,7 +425,7 @@
 be called, and a reply message returning the resulting output
 parameters from the object.
 
address@hidden dbus-call-method bus service path interface method &rest args
address@hidden dbus-call-method bus service path interface method &optional 
:timeout timeout &rest args
 This function calls @var{method} on the D-Bus @var{bus}.  @var{bus} is
 either the symbol @code{:system} or the symbol @code{:session}.
 
@@ -433,6 +433,12 @@
 D-Bus object path, @var{service} is registered at.  @var{interface} is
 an interface offered by @var{service}.  It must provide @var{method}.
 
+If the parameter @code{:timeout} is given, the following integer
address@hidden specifies the maximun number of milliseconds the method
+call must return.  The default value is 25.000.  If the method call
+doesn't return in time, a D-Bus error is raised (@pxref{Errors and
+Events}).
+
 All other arguments args are passed to @var{method} as arguments.
 They are converted into D-Bus types as described in @ref{Type
 Conversion}.
@@ -546,7 +552,8 @@
 can be composed like the input parameters in @ref{Type Conversion}.
 
 The default D-Bus timeout when waiting for a message reply is 25
-seconds.  Therefore, @var{handler} shall not last longer than
+seconds.  This value could be even smaller, depending on the calling
+client.  Therefore, @var{handler} shall not last longer than
 absolutely necessary.
 
 @code{dbus-register-method} returns a Lisp symbol, which can be used