[Bug 29523] improve documentation for TpAccountChannelRequest

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=29523

--- Comment #5 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2010-08-12 05:59:57 PDT ---
I've updated the branch with more docs and more user action time stuff. It
turns out that CurrentTime = 0 is part of the X11 protocol, and there are
matching constants in both Gdk and Clutter, so I think
tp_user_action_time_from_x11() is useful.

(In reply to comment #0)
> * tp_account_channel_request_new() would benefit from an example

Not done here; I think the best example would probably be to add higher-level
API (I'm not quite sure what shape that should be yet), include "this is
equivalent to tp_account_channel_request_new() with this @request" in its docs,
and add those to tp_account_channel_request_new() as a "see also".

> * An explanation of how {create,ensure}_and_handle work could be useful for
> some people.

I've added brief explanations of how they work behind the scenes.

> * ::re-handled should be better explained, also potentially with an example.

I explained why it's like it is, but didn't add an example. Example handlers
would be a great place to show off g-i, actually - we can add pygtk examples
without actually having to (build-)depend on Gtk :-)

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.