[telepathy-spec/master] Connection: deprecate pre-Requests channel listing

[Simon McVittie]

---
 spec/Connection.xml |   13 +++++++++++++
 1 files changed, 13 insertions(+), 0 deletions(-)

diff --git a/spec/Connection.xml b/spec/Connection.xml
index 2a98f2b..d2a374a 100644
--- a/spec/Connection.xml
+++ b/spec/Connection.xml
@@ -26,6 +26,7 @@ USA.</p>
     <tp:requires interface="org.freedesktop.Telepathy.Connection.Interface.Contacts"/>
 
     <tp:struct name="Channel_Info" array-name="Channel_Info_List">
+      <tp:deprecated version="0.17.UNRELEASED"/>
       <tp:docstring>A struct representing a channel, as returned by
         ListChannels on the Connection interface.</tp:docstring>
       <tp:member type="o" name="Channel">
@@ -274,6 +275,12 @@ USA.</p>
     </method>
 
     <method name="ListChannels" tp:name-for-bindings="List_Channels">
+      <tp:deprecated version="0.17.UNRELEASED">Use the
+        <tp:dbus-ref
+          namespace="org.freedesktop.Telepathy.Connection.Interface">Requests.Channels</tp:dbus-ref>
+        property instead.
+      </tp:deprecated>
+
       <arg direction="out" type="a(osuu)" tp:type="Channel_Info[]"
         name="Channel_Info">
         <tp:docstring>
@@ -291,6 +298,12 @@ USA.</p>
     </method>
 
     <signal name="NewChannel" tp:name-for-bindings="New_Channel">
+      <tp:deprecated version="0.17.UNRELEASED">Connection managers MUST still
+        emit this signal, but clients SHOULD listen for the <tp:dbus-ref
+          namespace="org.freedesktop.Telepathy.Connection.Interface">Requests.NewChannels</tp:dbus-ref>
+        signal instead.
+      </tp:deprecated>
+
       <arg name="Object_Path" type="o">
         <tp:docstring>
           A D-Bus object path for the channel object on this service
-- 
1.5.6.5