[Telepathy] [Bug 19096] New: TpConnection' s documentation should say that it needs to be "ready"

[bugzilla-daemon at freedesktop.org]

http://bugs.freedesktop.org/show_bug.cgi?id=19096

           Summary: TpConnection's documentation should say that it needs to
                    be "ready"
           Product: Telepathy
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: telepathy-glib
        AssignedTo: telepathy at lists.freedesktop.org
        ReportedBy: murrayc at murrayc.com


The TpConnection documentation
 
http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-connection.html#telepathy-glib-connection.description
does not mention that you need to wait until the connection is ready before you
can do anything with the connection.

Furthermore, the GError you get if you don't wait doesn't mention that that's
the problem. For instance, the GError from
tp_cli_connection_interface_simple_presence_call_set_presence() just says that
the connection doesn't support the SimplePresence interface, when the truth is
that it just doesn't know yet if it does.


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