[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] emacs/doc/misc dbus.texi
From: |
Michael Albinus |
Subject: |
[Emacs-diffs] emacs/doc/misc dbus.texi |
Date: |
Tue, 25 Aug 2009 08:42:13 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Michael Albinus <albinus> 09/08/25 08:42:13
Modified files:
doc/misc : dbus.texi
Log message:
* dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping.
Describe autostart behaviour of dbus-ping.
(Synchronous Methods, Asynchronous Methods): Use English numeric format
for timeout values.
CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/misc/dbus.texi?cvsroot=emacs&r1=1.35&r2=1.36
Patches:
Index: dbus.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/dbus.texi,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -b -r1.35 -r1.36
--- dbus.texi 16 Aug 2009 17:48:45 -0000 1.35
+++ dbus.texi 25 Aug 2009 08:42:13 -0000 1.36
@@ -180,22 +180,31 @@
string.
@end defun
address@hidden dbus-ping bus service
address@hidden dbus-ping bus service &optional timeout
Check whether the service name @var{service} is registered at D-Bus
address@hidden @var{service} might not have been started yet. The result
-is either @code{t} or @code{nil}.
address@hidden @var{service} might not have been started yet, it is
+autostarted if possible. The result is either @code{t} or @code{nil}.
@var{bus} must be either the symbol @code{:system} or the symbol
address@hidden:session}. @var{service} must be a string. Example:
address@hidden:session}. @var{service} must be a string. @var{timeout}, a
+nonnegative integer, specifies the maximum number of milliseconds
address@hidden must return. The default value is 25,000. Example:
@lisp
(message
"%s screensaver on board."
(cond
- ((dbus-ping :session "org.gnome.ScreenSaver") "Gnome")
- ((dbus-ping :session "org.freedesktop.ScreenSaver") "KDE")
+ ((dbus-ping :session "org.gnome.ScreenSaver" 100) "Gnome")
+ ((dbus-ping :session "org.freedesktop.ScreenSaver" 100) "KDE")
(t "No")))
@end lisp
+
+If it shall be checked whether @var{service} is already running
+without autostarting it, one shall apply
+
address@hidden
+(member service (dbus-list-known-names bus))
address@hidden lisp
@end defun
@defun dbus-get-unique-name bus
@@ -1078,7 +1087,7 @@
If the parameter @code{:timeout} is given, the following integer
@var{timeout} specifies the maximum number of milliseconds the method
-call must return. The default value is 25.000. If the method call
+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}).
@@ -1194,7 +1203,7 @@
If the parameter @code{:timeout} is given, the following integer
@var{timeout} specifies the maximum number of milliseconds a reply
-message must arrive. The default value is 25.000. If there is no
+message must arrive. The default value is 25,000. If there is no
reply message in time, a D-Bus error is raised (@pxref{Errors and
Events}).