Update to spec 0.23.2

Add:
  - TP_HASH_TYPE_NOT_DELEGATED_MAP
  - TP_STRUCT_TYPE_NOT_DELEGATED_ERROR
  - tp_type_dbus_hash_o_28ss_29

2 files changed, 74 insertions, 18 deletions

diff --git a/spec/Channel_Dispatcher.xml b/spec/Channel_Dispatcher.xml
index 2de528001..771d06089 100644
--- a/spec/Channel_Dispatcher.xml
+++ b/spec/Channel_Dispatcher.xml
@@ -571,19 +571,29 @@
 
     <method name="DelegateChannels"
             tp:name-for-bindings="Delegate_Channels">
-      <tp:added version="0.23.1" />
+      <tp:added version="0.23.1">
+        Implemented since telepathy-mission-control 5.7.12.
+      </tp:added>
+      <tp:changed version="0.23.2">This method now returns
+        <var>Delegated</var> and <var>Not_Delegated</var> instead of nothing.
+        <tp:dbus-ref namespace="ofdT.Client.Handler">HandleChannels</tp:dbus-ref>
+        is now called once per <var>Channel</var> in <var>Channels</var>.
+      </tp:changed>
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Called by a
         <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client">Handler</tp:dbus-ref>
           to redispatch a bunch of channels it is currently handling.</p>
 
-        <p>If another
-          <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client">Handler</tp:dbus-ref>
+        <p>For each <var>Channel</var> in <var>Channels</var>, if another
+          <tp:dbus-ref namespace="ofdT.Client">Handler</tp:dbus-ref>
           can be found,
-          <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client.Handler">HandleChannels</tp:dbus-ref>
-          will be called on it and this function will succeed. In that case,
-          the original <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client">Handler</tp:dbus-ref>
-          does not longer handle those channels.</p>
+          <tp:dbus-ref namespace="ofdT.Client.Handler">HandleChannels</tp:dbus-ref>
+          will be called on it until a
+          <tp:dbus-ref namespace="ofdT.Client">Handler</tp:dbus-ref>
+          accepts it.</p>
+
+        <p>This method returns once all the <var>Channels</var> have either
+          been accepted or rejected by Handlers.</p>
 
         <p>If this method fails, the original
           <tp:dbus-ref namespace="org.freedesktop.Telepathy.Client">Handler</tp:dbus-ref>
@@ -626,33 +636,79 @@
         </tp:docstring>
       </arg>
 
+      <arg direction="out" name="Delegated" type="ao">
+        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+          <p>The list of channels which have been delegated; the caller is no
+          longer handling these channels.</p>
+
+          <p>The client should remove these channels from its
+          <tp:dbus-ref namespace="ofdT.Client.Handler">HandledChannels</tp:dbus-ref>
+          property.</p>
+        </tp:docstring>
+      </arg>
+
+      <arg direction="out" name="Not_Delegated" type="a{o(ss)}"
+       tp:type="Not_Delegated_Map">
+        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+          <p>The list of channels which have NOT been delegated; the caller is still
+          handling these channels.</p>
+        </tp:docstring>
+      </arg>
+
       <tp:possible-errors>
         <tp:error name="org.freedesktop.Telepathy.Error.InvalidArgument">
           <tp:docstring>
             The Preferred_Handler is syntactically invalid or does
-            not start with <code>org.freedesktop.Telepathy.Client.</code> or
-            the Account does not exist.
+            not start with <code>org.freedesktop.Telepathy.Client.</code>.
           </tp:docstring>
         </tp:error>
 
         <tp:error name="org.freedesktop.Telepathy.Error.NotYours">
           <tp:docstring>
-            The caller is not currently handling the channels.
-          </tp:docstring>
-        </tp:error>
-
-        <tp:error name="org.freedesktop.Telepathy.Error.NotCapable">
-          <tp:docstring>
-            There is no other suitable Handler.
+            At least one <var>Channel</var> in <var>Channels</var> is not
+            currently handled by the caller. No <var>Channel</var> has been
+            delegated.
           </tp:docstring>
         </tp:error>
       </tp:possible-errors>
 
     </method>
 
+    <tp:mapping name="Not_Delegated_Map">
+      <tp:docstring>
+        A mapping associating not delegated channel with an error.
+      </tp:docstring>
+
+      <tp:member type="o" name="Channel">
+        <tp:docstring>
+          The path of the channel
+        </tp:docstring>
+      </tp:member>
+      <tp:member type="(ss)" name="Error" tp:type="Not_Delegated_Error">
+        <tp:docstring>
+          An error describing why the channel has not be delegated
+        </tp:docstring>
+      </tp:member>
+    </tp:mapping>
+
+    <tp:struct name="Not_Delegated_Error">
+      <tp:member type="s" name="Error_Name" tp:type="DBus_Error_Name">
+        <tp:docstring>
+          the name of a D-Bus error describing what went wrong.
+        </tp:docstring>
+      </tp:member>
+      <tp:member type="s" name="Error_Message">
+        <tp:docstring>
+          a human-readable informative error message.
+        </tp:docstring>
+      </tp:member>
+    </tp:struct>
+
     <method name="PresentChannel"
             tp:name-for-bindings="Present_Channel">
-      <tp:added version="0.23.1" />
+      <tp:added version="0.23.1">
+        Implemented since telepathy-mission-control 5.7.12.
+      </tp:added>
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Equivalent of calling
         <tp:dbus-ref namespace="org.freedesktop.Telepathy.ChannelDispatcher">EnsureChannel</tp:dbus-ref>
diff --git a/spec/all.xml b/spec/all.xml
index e23c6c6f1..ca6689f60 100644
--- a/spec/all.xml
+++ b/spec/all.xml
@@ -3,7 +3,7 @@
   xmlns:xi="http://www.w3.org/2001/XInclude">
 
 <tp:title>Telepathy D-Bus Interface Specification</tp:title>
-<tp:version>0.23.1</tp:version>
+<tp:version>0.23.2</tp:version>
 
 <tp:copyright>Copyright © 2005-2011 Collabora Limited</tp:copyright>
 <tp:copyright>Copyright © 2005-2011 Nokia Corporation</tp:copyright>