[Emacs-diffs] /srv/bzr/emacs/trunk r103178: * dbus.texi (Bus names): Adapt descriptions for

[Michael Albinus]

------------------------------------------------------------
revno: 103178
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Mon 2011-02-07 10:21:08 +0100
message:
  * dbus.texi (Bus names): Adapt descriptions for
  dbus-list-activatable-names and dbus-list-known-names.
modified:
  doc/misc/ChangeLog
  doc/misc/dbus.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2011-02-07 01:35:09 +0000
+++ b/doc/misc/ChangeLog        2011-02-07 09:21:08 +0000
@@ -1,3 +1,8 @@
+2011-02-07  Michael Albinus  <address@hidden>
+
+       * dbus.texi (Bus names): Adapt descriptions for
+       dbus-list-activatable-names and dbus-list-known-names.
+
 2011-02-07  Jay Belanger  <address@hidden>
 
        * calc.texi (Logarithmic Units): New section.

=== modified file 'doc/misc/dbus.texi'
--- a/doc/misc/dbus.texi        2011-01-25 04:08:28 +0000
+++ b/doc/misc/dbus.texi        2011-02-07 09:21:08 +0000
@@ -132,14 +132,24 @@
 registered names.  Internally they use the basic interface
 @samp{org.freedesktop.DBus}, which is supported by all objects of a bus.
 
address@hidden dbus-list-activatable-names
-This function returns the D-Bus service names, which can be activated.
-An activatable service is described in a service registration file.
-Under GNU/Linux, such files are located at
address@hidden/usr/share/dbus-1/services/}.
address@hidden dbus-list-activatable-names &optional bus
+This function returns the D-Bus service names, which can be activated
+for @var{bus}.  It must be either the symbol @code{:system} (the
+default) or the symbol @code{:session}.  An activatable service is
+described in a service registration file.  Under GNU/Linux, such files
+are located at @file{/usr/share/dbus-1/system-services/} (for the
address@hidden:system} bus) or @file{/usr/share/dbus-1/services/}.  An
+activatable service is not necessarily registered at @var{bus} at already.
 
 The result is a list of strings, which is @code{nil} when there are no
-activatable service names at all.
+activatable service names at all.  Example:
+
address@hidden
+;; Check, whether the document viewer can be accessed via D-Bus.
+(member "org.gnome.evince.Daemon"
+        (dbus-list-activatable-names :session))
address@hidden lisp
+
 @end defun
 
 @defun dbus-list-names bus
@@ -154,7 +164,7 @@
 @end defun
 
 @defun dbus-list-known-names bus
-Retrieves all services which correspond to a known name in @var{bus}.
+Retrieves all registered services which correspond to a known name in 
@var{bus}.
 A service has a known name if it doesn't start with @samp{:}.  The
 result is a list of strings, which is @code{nil} when there are no
 known names at all.