[Telepathy-commits] [telepathy-spec/master] ChannelRequest: reformat PreferredHandler, and observe that maybe it should just be a boolean for "I want this myself"

[Simon McVittie]

---
 spec/Channel_Request.xml |   19 +++++++++++--------
 1 files changed, 11 insertions(+), 8 deletions(-)

diff --git a/spec/Channel_Request.xml b/spec/Channel_Request.xml
index 5061da3..a3592a2 100644
--- a/spec/Channel_Request.xml
+++ b/spec/Channel_Request.xml
@@ -78,14 +78,17 @@
 
       <arg direction="in" name="Preferred_Handler" type="s"
         tp:type="DBus_Bus_Name">
-        <tp:docstring>
-          Either the well-known bus name of the preferred handler for this
-          channel, or an empty string to indicate that any handler would be
-          acceptable. The channel dispatcher SHOULD dispatch as many as
-          possible of the resulting channels (ideally, all of them)
-          to that handler, and SHOULD remember the preferred handler
-          so it can try to dispatch subsequent channels in the same bundle
-          to the same handler.
+        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+          <p>Either the well-known bus name of the preferred handler for this
+            channel, or an empty string to indicate that any handler would be
+            acceptable. The channel dispatcher SHOULD dispatch as many as
+            possible of the resulting channels (ideally, all of them)
+            to that handler, and SHOULD remember the preferred handler
+            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:docstring>
       </arg>
 
-- 
1.5.6.5