[Telepathy-commits] [telepathy-spec/master] Client.ChannelHandler: fill in more spec text

[Simon McVittie]

20080623181221-53eee-1bb0f3bad666d307c1259fd49561cbae63f22eb2.gz
---
 spec/Client_Channel_Handler.xml |   14 +++++++++++++-
 1 files changed, 13 insertions(+), 1 deletions(-)

diff --git a/spec/Client_Channel_Handler.xml b/spec/Client_Channel_Handler.xml
index 316e81f..39d71f0 100644
--- a/spec/Client_Channel_Handler.xml
+++ b/spec/Client_Channel_Handler.xml
@@ -33,18 +33,30 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
     <method name="HandleChannels">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Called by the channel dispatcher when an Approver indicates that
-          this client should handle this channel.</p>
+          this client should handle these channels.</p>
       </tp:docstring>
 
+      <!-- FIXME: other dispatching-related info? -->
+
       <arg name="Connection" type="o" direction="in">
         <tp:docstring>
+          The Connection with which the channels are associated. The
+          well-known bus name to use can be derived from this object
+          path by removing the leading '/' and replacing all subsequent
+          '/' by '.'.
         </tp:docstring>
       </arg>
 
       <arg name="Channels" type="a(oa{sv})" direction="in">
         <tp:docstring>
+          The channels and their immutable properties. Their well-known
+          bus name is the same as that of the Connection.
         </tp:docstring>
       </arg>
+
+      <tp:possible-errors>
+        <!-- FIXME -->
+      </tp:possible-errors>
     </method>
 
   </interface>
-- 
1.5.6.5