[Telepathy-commits] [telepathy-spec/master] ChannelRequest: explain when channels will be dispatched to handlers

[Simon McVittie]

20080711191606-53eee-5779693c9d9f39154cfa7af179680afee5152f84.gz
---
 spec/Channel_Request.xml |   15 +++++++++++++++
 1 files changed, 15 insertions(+), 0 deletions(-)

diff --git a/spec/Channel_Request.xml b/spec/Channel_Request.xml
index c27778a..ad95b31 100644
--- a/spec/Channel_Request.xml
+++ b/spec/Channel_Request.xml
@@ -132,6 +132,21 @@
           <p>The channels that were produced. The same comments as for
             <tp:dbus-ref namespace="org.freedesktop.Telepathy">Connection.Interface.Requests.DRAFT.RequestChannels</tp:dbus-ref>
             apply here.</p>
+
+          <!-- FIXME: is it necessary to have the flags here any more?
+          If not, replace Channel_Request_Response[] with
+          Channel_Details[] -->
+
+          <p>After signalling success in this way, the channel
+            dispatcher will also dispatch each channel that does
+            not have the Reused flag to an appropriate channel handler.</p>
+
+          <tp:rationale>
+            <p>It must be <em>after</em> so channel handlers can tell
+              which channels they're being given in order to satisfy their
+              own requests (and also which requests), and which channels
+              they're being given for some other reason.</p>
+          </tp:rationale>
         </tp:docstring>
       </arg>
 
-- 
1.5.6.5