aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMichael Albinus <albinus@detlef>2010-07-04 12:07:27 +0200
committerMichael Albinus <albinus@detlef>2010-07-04 12:07:27 +0200
commit820ae8fefa06d43cf543ad62a04f98048358de7c (patch)
treec52cb0ae9ac04538dde0c4fb09920d6bfe82959d /doc
parentb1ce08daa9bb90d7d4d6f978b9863c3853ca30cb (diff)
* dbus.texi (Receiving Method Calls): Add optional argument
EMITS-SIGNAL to `dbus-register-property'.
Diffstat (limited to 'doc')
-rw-r--r--doc/misc/ChangeLog5
-rw-r--r--doc/misc/dbus.texi10
2 files changed, 12 insertions, 3 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index a159715a69..4187d9909f 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,8 @@
+2010-07-04 Michael Albinus <[email protected]>
+
+ * dbus.texi (Receiving Method Calls): Add optional argument
+ EMITS-SIGNAL to `dbus-register-property'.
+
2010-06-10 Glenn Morris <[email protected]>
* idlwave.texi (Load-Path Shadows):
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index c92cb279f0..43e9278508 100644
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -1359,7 +1359,7 @@ The test runs then
@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 @@ only way to change their values. Properties with access type
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 @@ The interface @samp{org.freedesktop.DBus.Properties} is added to
(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"))