[Telepathy-commits] [telepathy-spec/master] MembersChangedDetailed: add member-ids detail
Will Thompson
will.thompson at collabora.co.uk
Thu Dec 18 04:31:36 PST 2008
---
spec/Channel_Interface_Group.xml | 17 +++++++++++++++++
1 files changed, 17 insertions(+), 0 deletions(-)
diff --git a/spec/Channel_Interface_Group.xml b/spec/Channel_Interface_Group.xml
index c005a62..3b56d23 100644
--- a/spec/Channel_Interface_Group.xml
+++ b/spec/Channel_Interface_Group.xml
@@ -753,6 +753,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</
<dt>change-reason (u â <tp:type>Channel_Group_Change_Reason</tp:type>)</dt>
<dd>A reason for the change.</dd>
+ <dt>member-ids (a{us} â <tp:type>Handle_Identifier_Map</tp:type>)</dt>
+ <dd>The string identifiers for handles mentioned in this signal, to
+ give clients the minimal information necessary to react to the
+ event without waiting for round-trips. Connection managers
+ SHOULD include the identifiers for members added to the group;
+ they MAY omit the identifiers for handles which have been removed
+ from the group.
+
+ <tp:rationale>
+ On IRC, an event such as a netsplit could cause the vast
+ majority of a channel to leave. Given that clients should
+ already know the identifiers of a channel's members, including
+ potentially hundreds of strings in the netsplit signal is
+ unnecessary.
+ </tp:rationale>
+ </dd>
+
<dt>message (s)</dt>
<dd>A string message from the server regarding the change</dd>
--
1.5.6.5
More information about the Telepathy-commits
mailing list