diff options
author | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2007-04-26 16:15:22 +0000 |
---|---|---|
committer | Simon McVittie <simon.mcvittie@collabora.co.uk> | 2007-04-26 16:15:22 +0000 |
commit | c012d023a6857d6eb94d5e0feecf0c5c92f2dced (patch) | |
tree | e10a2944067191a5f7fe6547fdafff8aef6aec57 | |
parent | 914e95c8c4d575c3a64362b60d7e5ba72e2f4ce9 (diff) |
Renaming: don't imply that the channel necessarily goes away when its contact has been renamed away
-rw-r--r-- | spec/Connection_Interface_Renaming.xml | 17 |
1 files changed, 9 insertions, 8 deletions
diff --git a/spec/Connection_Interface_Renaming.xml b/spec/Connection_Interface_Renaming.xml index 6beabb6a..bed7c6c9 100644 --- a/spec/Connection_Interface_Renaming.xml +++ b/spec/Connection_Interface_Renaming.xml @@ -35,15 +35,16 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</ <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 + <p>Any channels associated with the contact's original handle will + continue to be to that handle, and so are no longer useful (unless + the contact renames back, or another contact connects with that + unique ID). Clients may open a similar channel associated with the + new handle to continue communicating with the contact.</p> + + <p>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> + from the chat window, closing it, 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 |