[Bug 27860] New: Document that observers can be used to implement non-interactive approvers

[bugzilla-daemon at freedesktop.org]

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

           Summary: Document that observers can be used to implement
                    non-interactive approvers
           Product: Telepathy
           Version: git master
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-spec
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: will.thompson at collabora.co.uk
         QAContact: telepathy-bugs at lists.freedesktop.org


So it turns out that you can implement non-interactive approvers (for instance,
to shoot down spam IM channels before the tray icon blinks at the user, or to
grab a SASL channel before the user is prompted for a password) as observers,
as follows:

• When ObserveChannels() is called,
• Call Claim() on the CDO;
• Then return from ObserveChannels();
• and then Claim will return successfully if you claimed the channels, and
failure if someone else got there first.

This should be documented somewhere.

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