[next] telepathy-spec: Account: use PropertiesChanged instead of AccountPropertyChanged
Guillaume Desmottes
gdesmott at kemper.freedesktop.org
Tue Feb 11 23:52:52 PST 2014
Module: telepathy-spec
Branch: next
Commit: dab1a96513bed75fc21d65c89100be8e78609789
URL: http://cgit.freedesktop.org/telepathy/telepathy-spec/commit/?id=dab1a96513bed75fc21d65c89100be8e78609789
Author: Guillaume Desmottes <guillaume.desmottes at collabora.co.uk>
Date: Tue Feb 11 10:51:26 2014 +0100
Account: use PropertiesChanged instead of AccountPropertyChanged
https://bugs.freedesktop.org/show_bug.cgi?id=23148
---
spec/Account.xml | 28 +++++++---------------------
1 file changed, 7 insertions(+), 21 deletions(-)
diff --git a/spec/Account.xml b/spec/Account.xml
index 8e6efd0..a6db9c5 100644
--- a/spec/Account.xml
+++ b/spec/Account.xml
@@ -20,6 +20,8 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
</p>
</tp:license>
<interface name="im.telepathy.v1.Account">
+ <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal"
+ value="true"/>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>An Account object encapsulates the necessary details to make a
Telepathy connection.</p>
@@ -74,6 +76,9 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
</ul>
</tp:rationale>
+ <p>The standard D-Bus <code>PropertiesChanged</code> signal is used
+ for all properties change notifications.</p>
+
</tp:docstring>
<tp:added version="0.17.2"/>
<tp:changed version="0.17.6">moved the Avatar property to a separate
@@ -136,25 +141,6 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
</tp:docstring>
</signal>
- <signal name="AccountPropertyChanged"
- tp:name-for-bindings="Account_Property_Changed">
- <tp:docstring>
- The values of one or more properties on this interface (that do not
- specify that this signal does not apply to them) may have changed.
- This does not cover properties of other interfaces, which must
- provide their own change notification if appropriate.
- </tp:docstring>
-
- <arg name="Properties" type="a{sv}">
- <tp:docstring>
- A map from property names in this namespace (e.g.
- <tp:member-ref>Nickname</tp:member-ref>) to
- values. Properties whose values have not changed SHOULD be
- omitted, but this need not be done.
- </tp:docstring>
- </arg>
- </signal>
-
<property name="DisplayName" type="s" access="readwrite"
tp:name-for-bindings="Display_Name">
<tp:docstring>
@@ -603,13 +589,13 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
<tp:member-ref>Usable</tp:member-ref> changes to True),
ChangingPresence MUST change to True, and the two property changes MUST
be emitted in the same
- <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal, before the
+ <code>PropertiesChanged</code> signal, before the
Set method returns.</p>
<p>When the account manager succeeds or fails in changing the presence,
or the connection disconnects due to an error, ChangingPresence MUST
change to False as part of the same
- <tp:member-ref>AccountPropertyChanged</tp:member-ref> signal.</p>
+ <code>PropertiesChanged</code> signal.</p>
<tp:rationale>
<p>This allows UIs to indicate that a presence change is in progress
More information about the telepathy-commits
mailing list