changeset 109128:89fa0d8c2e83

* dbus.texi (Receiving Method Calls): Add optional argument EMITS-SIGNAL to `dbus-register-property'.
author Michael Albinus <albinus@detlef>
date Sun, 04 Jul 2010 12:07:27 +0200
parents 6b757d9cacac
children 907fcf8bd2ef
files doc/misc/ChangeLog doc/misc/dbus.texi
diffstat 2 files changed, 12 insertions(+), 3 deletions(-) [+]
line wrap: on
line diff
--- a/doc/misc/ChangeLog	Sun Jul 04 11:52:57 2010 +0200
+++ b/doc/misc/ChangeLog	Sun Jul 04 12:07:27 2010 +0200
@@ -1,3 +1,8 @@
+2010-07-04  Michael Albinus  <michael.albinus@gmx.de>
+
+	* dbus.texi (Receiving Method Calls): Add optional argument
+	EMITS-SIGNAL to `dbus-register-property'.
+
 2010-06-10  Glenn Morris  <rgm@gnu.org>
 
 	* idlwave.texi (Load-Path Shadows):
--- a/doc/misc/dbus.texi	Sun Jul 04 11:52:57 2010 +0200
+++ b/doc/misc/dbus.texi	Sun Jul 04 12:07:27 2010 +0200
@@ -1359,7 +1359,7 @@
 @end example
 @end defun
 
-@defun dbus-register-property bus service path interface property access value
+@defun dbus-register-property bus service path interface property access value &optional emits-signal
 With this function, an application declares a @var{property} on the D-Bus
 @var{bus}.
 
@@ -1387,7 +1387,11 @@
 
 The interface @samp{org.freedesktop.DBus.Properties} is added to
 @var{path}, including a default handler for the @samp{Get},
-@samp{GetAll} and @samp{Set} methods of this interface.  Example:
+@samp{GetAll} and @samp{Set} methods of this interface.  When
+@var{emits-signal} is non-nil, the signal @samp{PropertiesChanged} is
+sent when the property is changed by @code{dbus-set-property}.
+
+@noindent Example:
 
 @lisp
 (dbus-register-property
@@ -1399,7 +1403,7 @@
 
 (dbus-register-property
   :session "org.freedesktop.TextEditor" "/org/freedesktop/TextEditor"
-  "org.freedesktop.TextEditor" "version" :readwrite emacs-version)
+  "org.freedesktop.TextEditor" "version" :readwrite emacs-version t)
 
 @result{} ((:session "org.freedesktop.TextEditor" "version")
     ("org.freedesktop.TextEditor" "/org/freedesktop/TextEditor"))