From 4853beb4fbd0e618007649ffa1dc2a4b059af2ac Mon Sep 17 00:00:00 2001
From: Morgan Collett <morgan.collett@gmail.com>
Date: Tue, 02 Oct 2007 09:56:36 +0000
Subject: Document get_channels

---
diff --git a/sugar/presence/activity.py b/sugar/presence/activity.py
index 8e536af..ad5c4ca 100644
--- a/sugar/presence/activity.py
+++ b/sugar/presence/activity.py
@@ -244,9 +244,13 @@ class Activity(gobject.GObject):
     def get_channels(self):
         """Retrieve communications channel descriptions for the activity 
         
-        Returns (bus name, connection, channels) for the activity
-        
-        XXX what are those values?
+        Returns a tuple containing:
+            - the D-Bus well-known service name of the connection
+              (FIXME: this is redundant; in Telepathy it can be derived
+              from that of the connection)
+            - the D-Bus object path of the connection
+            - a list of D-Bus object paths representing the channels
+              associated with this activity
         """
         (bus_name, connection, channels) = self._activity.GetChannels()
         return bus_name, connection, channels
--
cgit v0.9.1