[Bug 30281] New: Account::haveConnection() and ::connectionStatus() are poorly documented

[bugzilla-daemon at freedesktop.org]

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

           Summary: Account::haveConnection() and ::connectionStatus() are
                    poorly documented
           Product: Telepathy
           Version: git master
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-qt4
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: will.thompson at collabora.co.uk
         QAContact: telepathy-bugs at lists.freedesktop.org


The spec's definition of
<http://telepathy.freedesktop.org/spec/Account.html#org.freedesktop.Telepathy.Account.ConnectionStatus>
is pretty clear about what its value will be in different states. TpQt4's
documentation is not. It's not obvious to an API user which method they should
use.

(I don't really see the point of haveConnection(); is it any easier than
checking if connection() returns non-0?)

-- 
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.