1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
<?xml version="1.0" ?>
<node name="/Connection_Interface_Renaming" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
<tp:copyright> Copyright (C) 2005, 2006 Collabora Limited </tp:copyright>
<tp:copyright> Copyright (C) 2005, 2006 Nokia Corporation </tp:copyright>
<tp:copyright> Copyright (C) 2006 INdT </tp:copyright>
<tp:license xmlns="http://www.w3.org/1999/xhtml">
<p>This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.</p>
<p>This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.</p>
<p>You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
</tp:license>
<interface name="org.freedesktop.Telepathy.Connection.Interface.Renaming">
<tp:requires interface="org.freedesktop.Telepathy.Connection"/>
<signal name="Renamed">
<arg name="original" type="u">
<tp:docstring>
The handle of the original identifier
</tp:docstring>
</arg>
<arg name="new" type="u">
<tp:docstring>
The handle of the new identifier
</tp:docstring>
</arg>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>Emitted when the unique identifier of a contact on the server
changes.</p>
<p>Each channel for which GetHandle() would return the original
handle should no longer be used to send messages, etc., but
should remain open so that pending messages can be retrieved.
Clients which are aware of Renaming may open a channel to the
new handle; for example, if a GUI client associates text
channels with chat windows, it should detach the old channel
from the chat window (retrieving all pending messages first),
and associate a channel to the new handle with the same window.
</p>
<p>If the contact's old handle is in any of the member lists of
a channel which has the groups interface, it will be removed from
the channel and the new handle will be added. The resulting
MembersChanged signal must be emitted <em>after</em> the Renamed
signal; the reason should be RENAMED.
</p>
<p>The handles may be either general-purpose or channel-specific.
If the original handle is general-purpose, the new handle must be
general-purpose; if the original handle is channel-specific, the
new handle must be channel-specific in the same channel.
</p>
</tp:docstring>
</signal>
<method name="RequestRename">
<arg direction="in" name="name" type="s">
<tp:docstring>
The desired identifier
</tp:docstring>
</arg>
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>Request that the user's own identifier is changed on the server.
If successful, a Renamed signal will be emitted for the current
"self handle" as returned by GetSelfHandle.</p>
<p>It is protocol-dependent how the identifier that's actually
used will be derived from the supplied identifier; some sort of
normalization might take place.</p>
</tp:docstring>
<tp:possible-errors>
<tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
<tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
<tp:error name="org.freedesktop.Telepathy.Error.NotAvailable"/>
<tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument"/>
<tp:error name="org.freedesktop.Telepathy.Error.PermissionDenied"/>
</tp:possible-errors>
</method>
<tp:docstring>
An interface on connections to support protocols where the unique
identifiers of contacts can change. Because handles are immutable,
this is represented by a pair of handles, that representing the
old name, and that representing the new one.
</tp:docstring>
</interface>
</node>
<!-- vim:set sw=2 sts=2 et ft=xml: -->
|
