[Telepathy-commits] [telepathy-spec/master] ChannelDispatcher: Document why Preferred_Handler isn't just a boolean

[Simon McVittie]

---
 spec/Channel_Dispatcher.xml |   11 +++++++++--
 1 files changed, 9 insertions(+), 2 deletions(-)

diff --git a/spec/Channel_Dispatcher.xml b/spec/Channel_Dispatcher.xml
index 3df871a..e60ea38 100644
--- a/spec/Channel_Dispatcher.xml
+++ b/spec/Channel_Dispatcher.xml
@@ -170,8 +170,15 @@
             so it can try to dispatch subsequent channels in the same bundle
             to the same handler.</p>
 
-          <p>FIXME: perhaps this should just be a boolean, for
-            "I want to claim the channel myself"</p>
+          <tp:rationale>
+            <p>This must be the well-known bus name, not the unique name,
+              to ensure that all handlers do indeed have the Client API,
+              and the Client object on the handler can be located easily.</p>
+
+            <p>This is partly so the channel dispatcher can call
+              HandleChannel on it, and partly so the channel dispatcher
+              can recover state if it crashes and is restarted.</p>
+          </tp:rationale>
         </tp:docstring>
       </arg>
 
-- 
1.5.6.5