[Telepathy-commits] [telepathy-spec/master] Observer: define how to pass account to ObserveChannels, and rename Other to Observer_Info

Simon McVittie simon.mcvittie at collabora.co.uk
Fri Sep 26 08:21:51 PDT 2008


---
 spec/Client_Observer.xml |   26 ++++++++++++++++++--------
 1 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/spec/Client_Observer.xml b/spec/Client_Observer.xml
index 4100ba3..6ded5d8 100644
--- a/spec/Client_Observer.xml
+++ b/spec/Client_Observer.xml
@@ -198,17 +198,27 @@ ObserverChannelFilter 1 org.freedesktop.Telepathy.Channel.FUTURE.Requested b=tru
         </tp:docstring>
       </arg>
 
-      <arg name="Other" type="a{sv}" direction="in">
+      <arg name="Observer_Info" type="a{sv}" direction="in">
         <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-          <p>Other information about these channels, in an as-yet unspecified
-            format.</p>
-
-          <tp:rationale>
-            <p>The idea is that this will include the object path of the
-              Account, if available, and anything else we think of later.</p>
-          </tp:rationale>
+          <p>Additional information about these channels. All keys are
+            optional, but the channel dispatcher SHOULD supply as many as
+            possible. Well-known keys and the types of the corresponding
+            values include:</p>
+
+          <dl>
+            <dt>account - o
+              (<tp:dbus-ref>org.freedesktop.Telepathy.Account</tp:dbus-ref>)
+            </dt>
+            <dd>The account with which this Connection is associated</dd>
+          </dl>
+
+          <p>(FIXME: what else?)</p>
+
+          <p>(FIXME: this is copied and pasted from Handler, we should
+            unify them somehow)</p>
         </tp:docstring>
       </arg>
+
     </method>
 
   </interface>
-- 
1.5.6.5




More information about the Telepathy-commits mailing list