[Telepathy-commits] [telepathy-spec/master] Handler.HandleChannels: add requests to Handler_Info.

[Simon McVittie]

They must be an array because a channel can satisfy multiple EnsureChannel
requests.

Also, add a FIXME note indicating the other possible approach, which
would be to call HandleChannels once per request that was satisfied.
---
 spec/Client_Handler.xml |   16 ++++++++++++++++
 1 files changed, 16 insertions(+), 0 deletions(-)

diff --git a/spec/Client_Handler.xml b/spec/Client_Handler.xml
index a95e453..022942f 100644
--- a/spec/Client_Handler.xml
+++ b/spec/Client_Handler.xml
@@ -120,6 +120,22 @@
               is to be handled for some reason not involving user action.
               Handlers SHOULD use this for focus-stealing prevention,
               if applicable.</dd>
+
+            <dt>requests - ao
+              (array of
+              <tp:dbus-ref>org.freedesktop.Telepathy.ChannelRequest</tp:dbus-ref>)
+            </dt>
+            <dd><p>The request(s) satisfied by these channels.</p>
+
+              <tp:rationale>
+                <p>A single channel can simultaneously satisfy up to one
+                  CreateChannel request, and any number of EnsureChannel
+                  requests.</p>
+              </tp:rationale>
+
+              <p>(FIXME: or should we cause one call to this method per
+                request satisfied?)</p>
+            </dd>
           </dl>
 
           <p>(FIXME: what else?)</p>
-- 
1.5.6.5