Bug 39660 - high-level API for Connection.Interface.ContactGroups
Summary: high-level API for Connection.Interface.ContactGroups
Status: RESOLVED FIXED
Alias: None
Product: Telepathy
Classification: Unclassified
Component: tp-glib (show other bugs)
Version: unspecified
Hardware: Other All
: medium normal
Assignee: Telepathy bugs list
QA Contact: Telepathy bugs list
URL: http://cgit.collabora.com/git/user/xc...
Whiteboard:
Keywords: patch
Depends on:
Blocks:
 
Reported: 2011-07-29 01:23 UTC by Xavier Claessens
Modified: 2011-08-03 12:05 UTC (History)
0 users

See Also:
i915 platform:
i915 features:


Attachments
Add TP_CONNECTION_FEATURE_CONTACT_GROUPS to prepare the list of groups on the connection (19.85 KB, patch)
2011-08-03 06:45 UTC, Guillaume Desmottes
Details | Splinter Review

Description Xavier Claessens 2011-07-29 01:23:56 UTC
TpContact already use it do get its list of groups, and we have _async() wrapper for all actions. What's missing is fetching Connection properties and the whole set of groups on the connection.
Comment 1 Xavier Claessens 2011-07-29 01:25:43 UTC
Done in that branch: http://cgit.collabora.com/git/user/xclaesse/telepathy-glib.git/log/?h=contact-groups
Comment 2 Guillaume Desmottes 2011-08-03 06:45:07 UTC
Created attachment 49875 [details] [review]
Add TP_CONNECTION_FEATURE_CONTACT_GROUPS to prepare the list of groups on the connection
Comment 3 Guillaume Desmottes 2011-08-03 07:05:47 UTC
Review of attachment 49875 [details] [review]:

::: telepathy-glib/connection-contact-list.c
@@ +1011,3 @@
+ *
+ * When this feature is prepared, the contact groups properties of the
+ * Connection has been retrieved.

I'd list all the properties needing this feature to be prepared. You should also mention that the 3 sigs won't be fired until this has been prepared.

::: telepathy-glib/connection.c
@@ +2024,3 @@
+   * #TpContact::contact-groups-changed signals that add some members. When this
+   * signal is emitted, #TpConnection:contact-groups property is already
+  param_spec = g_param_spec_uint ("group-storage",

You should document that those signals need the feature to be prepared.
Comment 4 Xavier Claessens 2011-08-03 12:00:19 UTC
(In reply to comment #3)
> Review of attachment 49875 [details] [review]:
> 
> ::: telepathy-glib/connection-contact-list.c
> @@ +1011,3 @@
> + *
> + * When this feature is prepared, the contact groups properties of the
> + * Connection has been retrieved.
> 
> I'd list all the properties needing this feature to be prepared. You should
> also mention that the 3 sigs won't be fired until this has been prepared.

Other feature documentation does not do that, afaik. IMO it is too easy to get it outdated when adding new properties. Each property says which feature needs to be prepared already.

> ::: telepathy-glib/connection.c
> @@ +2024,3 @@
> +   * #TpContact::contact-groups-changed signals that add some members. When
> this
> +   * signal is emitted, #TpConnection:contact-groups property is already
> +  param_spec = g_param_spec_uint ("group-storage",
> 
> You should document that those signals need the feature to be prepared.

done


Use of freedesktop.org services, including Bugzilla, is subject to our Code of Conduct. How we collect and use information is described in our Privacy Policy.