diff options
Diffstat (limited to 'spec')
| -rw-r--r-- | spec/Channel.xml | 2 | ||||
| -rw-r--r-- | spec/Connection.xml | 42 |
2 files changed, 42 insertions, 2 deletions
diff --git a/spec/Channel.xml b/spec/Channel.xml index e0fa76594..12a486e4c 100644 --- a/spec/Channel.xml +++ b/spec/Channel.xml @@ -390,7 +390,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="org.freedesktop.Telepathy">Connection.SelfHandleChanged</tp:dbus-ref>), + namespace="org.freedesktop.Telepathy">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 6a560fc30..ed0243786 100644 --- a/spec/Connection.xml +++ b/spec/Connection.xml @@ -145,6 +145,8 @@ USA.</p> <tp:added version="0.17.10">Clients MAY assume that if the SelfHandle property exists, this signal will be emitted when necessary.</tp:added> + <tp:deprecated version="0.UNRELEASED">Use SelfContactChanged to get the + new SelfID at the same time</tp:deprecated> <arg type="u" tp:type="Contact_Handle" name="Self_Handle"> <tp:docstring> @@ -153,13 +155,38 @@ USA.</p> </arg> </signal> + <signal name="SelfContactChanged" + tp:name-for-bindings="Self_Contact_Changed"> + <tp:docstring> + 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.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"> + <tp:docstring> + 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" type="u" tp:type="Contact_Handle" access="read"> <tp:docstring> 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> @@ -169,6 +196,19 @@ USA.</p> method.</tp:added> </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> + <method name="GetSelfHandle" tp:name-for-bindings="Get_Self_Handle"> <arg direction="out" type="u" tp:type="Contact_Handle" name="Self_Handle"> |