[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