[next] telepathy-spec: Connection: add SelfID property and SelfContactChanged signal

[Xavier Claessens]

Module: telepathy-spec
Branch: next
Commit: aebf12ecaa838ac3f5aa7e3b6e5608f4222a5ada
URL:    http://cgit.freedesktop.org/telepathy/telepathy-spec/commit/?id=aebf12ecaa838ac3f5aa7e3b6e5608f4222a5ada

Author: Xavier Claessens <xavier.claessens at collabora.co.uk>
Date:   Wed May  9 12:47:37 2012 +0200

Connection: add SelfID property and SelfContactChanged signal

---

 spec/Channel.xml    |    2 +-
 spec/Connection.xml |   31 +++++++++++++++++++++++++------
 2 files changed, 26 insertions(+), 7 deletions(-)

diff --git a/spec/Channel.xml b/spec/Channel.xml
index 12c85f8..194f596 100644
--- a/spec/Channel.xml
+++ b/spec/Channel.xml
@@ -271,7 +271,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
         <tp:rationale>
           <p>On some protocols, the SelfHandle may change (as signalled by
             <tp:dbus-ref
-              namespace="im.telepathy1">Connection.SelfHandleChanged</tp:dbus-ref>),
+              namespace="im.telepathy1">Connection.SelfContactChanged</tp:dbus-ref>),
             but this property is immutable. Hence, locally-requested channels'
             InitiatorHandle and InitiatorID may not match the current
             SelfHandle; <tp:member-ref>Requested</tp:member-ref> can be used to
diff --git a/spec/Connection.xml b/spec/Connection.xml
index d0a9b22..b412ec3 100644
--- a/spec/Connection.xml
+++ b/spec/Connection.xml
@@ -79,16 +79,17 @@ USA.</p>
       </tp:docstring>
     </property>
 
-    <signal name="SelfHandleChanged"
-        tp:name-for-bindings="Self_Handle_Changed">
+    <signal name="SelfContactChanged"
+        tp:name-for-bindings="Self_Contact_Changed">
       <tp:docstring>
-        Emitted whenever the <tp:member-ref>SelfHandle</tp:member-ref> property
+        Emitted whenever the <tp:member-ref>SelfHandle</tp:member-ref> and
+        <tp:member-ref>SelfID</tp:member-ref> property
         changes. If the connection
         is not yet in the CONNECTED state, this signal is not guaranteed
         to be emitted.
       </tp:docstring>
-      <tp:added version="0.17.10">Clients MAY assume that if the
-        SelfHandle property exists, this signal will be emitted when
+      <tp:added version="0.UNRELEASED">Clients MAY assume that if the
+        SelfHandle and SelfID property exists, this signal will be emitted when
         necessary.</tp:added>
 
       <arg type="u" tp:type="Contact_Handle" name="Self_Handle">
@@ -96,6 +97,11 @@ USA.</p>
           The new value of the SelfHandle property.
         </tp:docstring>
       </arg>
+      <arg type="s" name="Self_ID">
+        <tp:docstring>
+          The new value of the SelfID property.
+        </tp:docstring>
+      </arg>
     </signal>
 
     <property name="SelfHandle" tp:name-for-bindings="Self_Handle"
@@ -104,13 +110,26 @@ USA.</p>
         The handle which represents the user on this connection, which will
         remain valid for the lifetime of this connection, or until a change
         in the user's identifier is signalled by the
-        <tp:member-ref>SelfHandleChanged</tp:member-ref> signal.
+        <tp:member-ref>SelfContactChanged</tp:member-ref> signal.
         If the connection is not yet in the CONNECTED state, the value of
         this property MAY be zero.
       </tp:docstring>
       <tp:added version="0.17.10"/>
     </property>
 
+    <property name="SelfID" tp:name-for-bindings="Self_ID"
+      type="s" access="read">
+      <tp:docstring>
+        The identifier which represents the user on this connection, which will
+        remain valid for the lifetime of this connection, or until a change
+        in the user's identifier is signalled by the
+        <tp:member-ref>SelfContactChanged</tp:member-ref> signal.
+        If the connection is not yet in the CONNECTED state, the value of
+        this property MAY be empty string.
+      </tp:docstring>
+      <tp:added version="0.UNRELEASED"/>
+    </property>
+
     <property name="Status" tp:name-for-bindings="Status"
       access="read" type="u" tp:type="Connection_Status">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">