summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSimon McVittie <simon.mcvittie@collabora.co.uk>2007-04-26 16:15:22 +0000
committerSimon McVittie <simon.mcvittie@collabora.co.uk>2007-04-26 16:15:22 +0000
commitc012d023a6857d6eb94d5e0feecf0c5c92f2dced (patch)
treee10a2944067191a5f7fe6547fdafff8aef6aec57
parent914e95c8c4d575c3a64362b60d7e5ba72e2f4ce9 (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.xml17
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