[Bug 29523] improve documentation for TpAccountChannelRequest

[bugzilla-daemon at freedesktop.org]

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

Simon McVittie <simon.mcvittie at collabora.co.uk> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                URL|http://git.collabora.co.uk/ |
                   |?p=user/smcv/telepathy-glib |
                   |-smcv.git;a=shortlog;h=refs |
                   |/heads/user-action-times    |
  Status Whiteboard|r+                          |
           Keywords|patch                       |

--- Comment #10 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2010-08-24 09:47:03 PDT ---
(In reply to comment #9)
> The documentation doesn't currently discuss the purpose of @context. i.e. if
> you pass a pointer to store the context in, are you then responsible for
> calling accept/fail/delay? (It seems you are not, which makes me wonder the
> purpose of providing the context).

The purpose is so you can call methods on @context to retrieve information from
Handler_Info, but it's impossible to give a concrete example because we don't
define any keys yet.

For instance, if we were to define a Handler_Info key "approver" that's the
unique name of the process that called HandleWith(), I'd add:

    const gchar *tp_handle_channels_context_get_approver (TpHCC *);

and that'd be the first example of a use for @context.

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