From 1ff98217da213c4b933bbb9e70bf6f18fbcfc0f8 Mon Sep 17 00:00:00 2001 From: Michael Albinus Date: Mon, 7 Feb 2011 10:21:08 +0100 Subject: [PATCH] * dbus.texi (Bus names): Adapt descriptions for dbus-list-activatable-names and dbus-list-known-names. --- doc/misc/ChangeLog | 5 +++++ doc/misc/dbus.texi | 24 +++++++++++++++++------- 2 files changed, 22 insertions(+), 7 deletions(-) diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 5103872613..53109fe794 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog @@ -1,3 +1,8 @@ +2011-02-07 Michael Albinus + + * dbus.texi (Bus names): Adapt descriptions for + dbus-list-activatable-names and dbus-list-known-names. + 2011-02-07 Jay Belanger * calc.texi (Logarithmic Units): New section. diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi index e50f48dcec..64d577f438 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi @@ -132,14 +132,24 @@ There are several basic functions which inspect the buses for registered names. Internally they use the basic interface @samp{org.freedesktop.DBus}, which is supported by all objects of a bus. -@defun 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 -@file{/usr/share/dbus-1/services/}. +@defun 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 +@code{: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: + +@lisp +;; Check, whether the document viewer can be accessed via D-Bus. +(member "org.gnome.evince.Daemon" + (dbus-list-activatable-names :session)) +@end lisp + @end defun @defun dbus-list-names bus @@ -154,7 +164,7 @@ strings like @samp{org.freedesktop.DBus}. Names starting with @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. -- 2.20.1