Commit 32a73cb1 authored by Xavier Claessens's avatar Xavier Claessens

Backport SelfID from next

parent dfde6d37
...@@ -390,7 +390,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ ...@@ -390,7 +390,7 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<tp:rationale> <tp:rationale>
<p>On some protocols, the SelfHandle may change (as signalled by <p>On some protocols, the SelfHandle may change (as signalled by
<tp:dbus-ref <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' but this property is immutable. Hence, locally-requested channels'
InitiatorHandle and InitiatorID may not match the current InitiatorHandle and InitiatorID may not match the current
SelfHandle; <tp:member-ref>Requested</tp:member-ref> can be used to SelfHandle; <tp:member-ref>Requested</tp:member-ref> can be used to
......
...@@ -145,6 +145,8 @@ USA.</p> ...@@ -145,6 +145,8 @@ USA.</p>
<tp:added version="0.17.10">Clients MAY assume that if the <tp:added version="0.17.10">Clients MAY assume that if the
SelfHandle property exists, this signal will be emitted when SelfHandle property exists, this signal will be emitted when
necessary.</tp:added> 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"> <arg type="u" tp:type="Contact_Handle" name="Self_Handle">
<tp:docstring> <tp:docstring>
...@@ -153,13 +155,38 @@ USA.</p> ...@@ -153,13 +155,38 @@ USA.</p>
</arg> </arg>
</signal> </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" <property name="SelfHandle" tp:name-for-bindings="Self_Handle"
type="u" tp:type="Contact_Handle" access="read"> type="u" tp:type="Contact_Handle" access="read">
<tp:docstring> <tp:docstring>
The handle which represents the user on this connection, which will The handle which represents the user on this connection, which will
remain valid for the lifetime of this connection, or until a change remain valid for the lifetime of this connection, or until a change
in the user's identifier is signalled by the 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 If the connection is not yet in the CONNECTED state, the value of
this property MAY be zero. this property MAY be zero.
</tp:docstring> </tp:docstring>
...@@ -169,6 +196,19 @@ USA.</p> ...@@ -169,6 +196,19 @@ USA.</p>
method.</tp:added> method.</tp:added>
</property> </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"> <method name="GetSelfHandle" tp:name-for-bindings="Get_Self_Handle">
<arg direction="out" type="u" tp:type="Contact_Handle" <arg direction="out" type="u" tp:type="Contact_Handle"
name="Self_Handle"> name="Self_Handle">
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment