diff doc/misc/dbus.texi @ 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 691c23d02cec
children 29eae48799da
line wrap: on
line diff
--- 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"))