[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