[Bug 29560] New: Messages should document at what points errors can be reported

[bugzilla-daemon at freedesktop.org]

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

           Summary: Messages should document at what points errors can be
                    reported
           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


It's a bit confusing that SendMessage() may return an error, but if it succeeds
you still might later get a failed delivery report, since it returning just
means “I submitted this message to the server”.

I think this behaviour is okay, but it should be explicitly documented in the
Messages interface. SendMessage() and MessageSent do say that they only mean
the message was submitted, but nothing is really mentioned up-front about
failed delivery reports.

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