[Telepathy-commits] [telepathy-spec/master] Client.ChannelHandler: add a placeholder HandlerChannelFilter property

[Simon McVittie]

20080624150519-53eee-77ca35862af501cad954a58445150123ee142289.gz
---
 spec/Client_Channel_Handler.xml |   17 +++++++++++++++++
 1 files changed, 17 insertions(+), 0 deletions(-)

diff --git a/spec/Client_Channel_Handler.xml b/spec/Client_Channel_Handler.xml
index 39d71f0..4007eac 100644
--- a/spec/Client_Channel_Handler.xml
+++ b/spec/Client_Channel_Handler.xml
@@ -30,6 +30,23 @@ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
         process handling channels of a particular type.</p>
     </tp:docstring>
 
+    <property name="HandlerChannelFilter" type="v">
+      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
+        <p>A specification of the channels that this channel handler can
+          deal with. It will be offered to approvers as a potential
+          channel handler for bundles that contain only suitable channels,
+          or for suitable channels that must be handled separately.</p>
+
+        <p>For channel handlers that have a .client file, the channel
+          dispatcher may discover this property from the
+          [org.freedesktop.Telepathy.Client.ChannelHandler.DRAFT] section of
+          the .client file. (FIXME: what are the keys and their values?)</p>
+
+        <p>FIXME: the type 'v' is a placeholder and needs replacing with
+          something suitable.</p>
+      </tp:docstring>
+    </property>
+
     <method name="HandleChannels">
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
         <p>Called by the channel dispatcher when an Approver indicates that
-- 
1.5.6.5