extensions: remove ContactCapabilities

3 files changed, 0 insertions, 248 deletions

diff --git a/extensions/Connection_Interface_Contact_Capabilities.xml b/extensions/Connection_Interface_Contact_Capabilities.xml
deleted file mode 100644
index 50f8b789e..000000000
--- a/extensions/Connection_Interface_Contact_Capabilities.xml
+++ /dev/null
@@ -1,245 +0,0 @@
-<?xml version="1.0" ?>
-<node name="/Connection_Interface_Contact_Capabilities" xmlns:tp="http://telepathy.freedesktop.org/wiki/DbusSpec#extensions-v0">
-  <tp:copyright> Copyright (C) 2005, 2006, 2008 Collabora Limited </tp:copyright>
-  <tp:copyright> Copyright (C) 2005, 2006, 2008 Nokia Corporation </tp:copyright>
-  <tp:copyright> Copyright (C) 2006 INdT </tp:copyright>
-  <tp:license xmlns="http://www.w3.org/1999/xhtml">
-    <p>This library is free software; you can redistribute it and/or
-modify it under the terms of the GNU Lesser General Public
-License as published by the Free Software Foundation; either
-version 2.1 of the License, or (at your option) any later version.</p>
-
-<p>This library is distributed in the hope that it will be useful,
-but WITHOUT ANY WARRANTY; without even the implied warranty of
-MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-Lesser General Public License for more details.</p>
-
-<p>You should have received a copy of the GNU Lesser General Public
-License along with this library; if not, write to the Free Software
-Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.</p>
-  </tp:license>
-  <interface name="org.freedesktop.Telepathy.Connection.Interface.ContactCapabilities">
-    <tp:requires interface="org.freedesktop.Telepathy.Connection"/>
-    <tp:added version="0.17.UNRELEASED">(as stable API)</tp:added>
-
-    <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-      <p>Contact capabilities describe the channel classes which may be
-        created with a given contact in advance of attempting to create a
-        channel. Each capability represents a commitment by the
-        connection manager that it will ordinarily be able to create a channel
-        with a contact when given a request with the properties defined by the
-        channel class.</p>
-
-      <p>Capabilities pertain to particular contact handles, and represent
-        activities such as having a text chat, a voice call with the user or a
-        stream tube of a defined type.</p>
-
-      <p>This interface also enables user interfaces to notify the connection
-        manager what capabilities to advertise for the user to other contacts.
-        This is done by using the
-        <tp:member-ref>UpdateCapabilities</tp:member-ref> method.</p>
-
-      <tp:rationale>
-        <p>XMPP is a major user of this interface: XMPP contacts will not,
-          in general, be callable using VoIP unless they advertise suitable
-          Jingle capabilities.</p>
-
-        <p>Many other protocols also have some concept of capability flags,
-          which this interface exposes in a protocol-independent way.</p>
-      </tp:rationale>
-    </tp:docstring>
-
-    <tp:struct name="Handler_Capabilities"
-      array-name="Handler_Capabilities_List">
-      <tp:docstring>
-        A structure representing the capabilities of a single client.
-      </tp:docstring>
-
-      <tp:member name="Well_Known_Name" type="s" tp:type="DBus_Well_Known_Name">
-        <tp:docstring>
-          For implementations of the <tp:dbus-ref
-            namespace="org.freedesktop.Telepathy">Client</tp:dbus-ref>
-          interface, the well-known bus name name of the client; for any other
-          process, any other reversed domain name that uniquely identifies it.
-        </tp:docstring>
-      </tp:member>
-
-      <tp:member name="Channel_Classes" type="aa{sv}"
-           tp:type="String_Variant_Map[]">
-        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          An array of channel classes that can be handled by this client.
-          This will usually be a copy of the client's <tp:dbus-ref
-            namespace="org.freedesktop.Telepathy.Client.Handler">HandlerChannelFilter</tp:dbus-ref>
-          property.
-        </tp:docstring>
-      </tp:member>
-
-      <tp:member name="Capabilities"
-        type="as" tp:type="Handler_Capability_Token[]">
-        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          An array of client capabilities supported by this client, to be
-          used by the connection manager to determine what capabilities to
-          advertise. This will usually be a copy of the client's <tp:dbus-ref
-            namespace="org.freedesktop.Telepathy.Client.Handler">Capabilities</tp:dbus-ref>
-          property.
-        </tp:docstring>
-      </tp:member>
-    </tp:struct>
-
-    <method name="UpdateCapabilities" tp:name-for-bindings="Update_Capabilities">
-      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-        <p>Alter the connection's advertised capabilities to include
-          the intersection of the given clients' capabilities with what the
-          connection manager is able to implement.</p>
-
-        <p>On connections managed by the ChannelDispatcher, processes other
-          than the ChannelDispatcher SHOULD NOT call this method, and the
-          ChannelDispatcher SHOULD use this method to advertise the
-          capabilities of all the registered <tp:dbus-ref
-            namespace="org.freedesktop.Telepathy">Client.Handler</tp:dbus-ref>
-          implementations.On connections not managed by the ChannelDispatcher,
-          clients MAY use this method directly, to indicate the channels they
-          will handle and the extra capabilities they have.</p>
-
-        <p>Upon a successful invocation of this method, the connection manager
-          will only emit the
-          <tp:member-ref>ContactCapabilitiesChanged</tp:member-ref> signal
-          for the user's <tp:dbus-ref
-            namespace="org.freedesktop.Telepathy.Connection">SelfHandle</tp:dbus-ref>
-          if, in the underlying protocol, the new capabilities are distinct
-          from the previous state.</p>
-
-        <tp:rationale>
-          <p>The connection manager will essentially intersect the provided
-            capabilities and the channel classes it implements. Therefore,
-            certain properties which are never fixed for a channel class
-            (such as the target handle, or the Parameters property of a tube
-            channel) will almost certainly not be advertised.</p>
-        </tp:rationale>
-
-        <p>This method MAY be called on a newly-created connection while it
-          is still in the DISCONNECTED state, to request that when the
-          connection connects, it will do so with the appropriate
-          capabilities. Doing so MUST NOT fail.</p>
-      </tp:docstring>
-
-      <arg direction="in" name="Handler_Capabilities" type="a(saa{sv}as)"
-        tp:type="Handler_Capabilities[]">
-        <tp:docstring>
-          <p>The capabilities of one or more clients.</p>
-
-          <p>For each client in the given list, any capabilities previously
-            advertised for the same client name are discarded, then replaced by
-            the capabilities indicated.</p>
-
-          <p>As a result, if a client becomes unavailable, this method SHOULD
-            be called with a <tp:type>Handler_Capabilities</tp:type> structure
-            containing its name, an empty list of channel classes, and an
-            empty list of capabilities. When this is done, the connection
-            manager SHOULD free all memory associated with that client name.</p>
-
-          <tp:rationale>
-            <p>This method takes a list of clients so that
-              when the channel dispatcher first calls it (with a list of all
-              the Handlers that are initially available), the changes can be
-              made atomically, with only one transmission of updated
-              capabilities to the network. Afterwards, the channel dispatcher
-              will call this method with a single-element list every time
-              a Handler becomes available or unavailable.</p>
-          </tp:rationale>
-
-          <p>The connection manager MUST ignore any channel classes and client
-            capabilities for which there is no representation in the protocol
-            or no support in the connection manager.</p>
-        </tp:docstring>
-      </arg>
-
-      <tp:possible-errors>
-        <tp:error name="org.freedesktop.Telepathy.Error.NetworkError"/>
-      </tp:possible-errors>
-    </method>
-
-    <method name="GetContactCapabilities"
-            tp:name-for-bindings="Get_Contact_Capabilities">
-      <arg direction="in" name="handles" type="au" tp:type="Contact_Handle[]">
-        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          <p>An array of contact handles for this connection.</p>
-
-          <p>The handle zero MUST NOT be included in the request.</p>
-        </tp:docstring>
-      </arg>
-      <arg direction="out" type="a{ua(a{sv}as)}"
-           tp:type="Contact_Capabilities_Map" name="Contact_Capabilities">
-        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          An array of structures containing:
-          <ul>
-            <li>a dictionary mapping the channel properties to their values.</li>
-            <li>an array of additional allowed properties</li>
-          </ul>
-        </tp:docstring>
-      </arg>
-      <tp:docstring>
-        Returns an array of enhanced capabilities for the given contact handles.
-      </tp:docstring>
-      <tp:possible-errors>
-        <tp:error name="org.freedesktop.Telepathy.Error.Disconnected"/>
-        <tp:error name="org.freedesktop.Telepathy.Error.InvalidHandle">
-          <tp:docstring>
-            The handle does not represent a contact. Zero is always invalid.
-          </tp:docstring>
-        </tp:error>
-      </tp:possible-errors>
-    </method>
-
-    <signal name="ContactCapabilitiesChanged"
-            tp:name-for-bindings="Contact_Capabilities_Changed">
-      <arg name="caps" type="a{ua(a{sv}as)}"
-           tp:type="Contact_Capabilities_Map">
-        <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          All the capabilities of the contacts
-        </tp:docstring>
-      </arg>
-      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-        <p>Announce that there has been a change of capabilities on the
-          given handles. A single signal can be emitted for several
-        contacts.</p>
-
-        <tp:rationale>
-          <p>The underlying protocol can get several contacts' capabilities at
-            the same time.</p>
-        </tp:rationale>
-
-      </tp:docstring>
-    </signal>
-
-  <tp:mapping name="Contact_Capabilities_Map"
-              array-name="Contact_Capabilities_Map_List">
-    <tp:docstring>A mapping from contact handle to their capabilities.
-    </tp:docstring>
-    <tp:member type="u" name="Key" tp:type="Contact_Handle">
-      <tp:docstring>
-        A contact handle.
-      </tp:docstring>
-    </tp:member>
-    <tp:member type="a(a{sv}as)" name="Value"
-               tp:type="Requestable_Channel_Class[]">
-      <tp:docstring>
-        The contact capabilities.
-      </tp:docstring>
-    </tp:member>
-  </tp:mapping>
-
-    <tp:contact-attribute name="capabilities"
-      type="a(a{sv}as)" tp:type="Requestable_Channel_Class[]">
-      <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-        <p>The same structs that would be returned by
-          <tp:member-ref>GetContactCapabilities</tp:member-ref>.
-          Omitted from the result if the contact's capabilities
-          are not known; present in the result as an empty array if the
-          contact is known to have no capabilities at all.</p>
-      </tp:docstring>
-    </tp:contact-attribute>
-
-  </interface>
-</node>
-<!-- vim:set sw=2 sts=2 et ft=xml: -->
diff --git a/extensions/Makefile.am b/extensions/Makefile.am
index d4d542640..f36555296 100644
--- a/extensions/Makefile.am
+++ b/extensions/Makefile.am
@@ -6,7 +6,6 @@ EXTRA_DIST = \
     all.xml \
     Channel_Bundle.xml \
     Channel_Future.xml \
-    Connection_Interface_Contact_Capabilities.xml \
     Connection_Interface_Contact_Info.xml \
     Channel_Type_Contact_Search.xml \
     Debug.xml \
diff --git a/extensions/all.xml b/extensions/all.xml
index 79133c937..5127e065b 100644
--- a/extensions/all.xml
+++ b/extensions/all.xml
@@ -43,8 +43,6 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA</p>
 <xi:include href="OLPC_Channel_Type_BuddyView.xml"/>
 <xi:include href="OLPC_Channel_Type_ActivityView.xml"/>
 
-<xi:include href="Connection_Interface_Contact_Capabilities.xml"/>
-
 <xi:include href="Channel_Type_Contact_Search.xml"/>
 <xi:include href="Connection_Interface_Contact_Info.xml"/>