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.</
<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
......
......@@ -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">
......
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