[Bug 26494] New: Misleading deprecation for tp_cli_channel_type_text_call_list_pending_messages

[bugzilla-daemon at freedesktop.org]

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

           Summary: Misleading deprecation for
                    tp_cli_channel_type_text_call_list_pending_messages
           Product: Telepathy
           Version: unspecified
          Platform: Other
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: medium
         Component: tp-doc
        AssignedTo: telepathy-bugs at lists.freedesktop.org
        ReportedBy: cosimo.alfarano at collabora.co.uk


The doc for tp_cli_channel_type_text_call_list_pending_messages (ie
http://telepathy.freedesktop.org/doc/telepathy-glib/telepathy-glib-channel-text.html)
defines the method as deprecated:

<quote>
tp_cli_channel_type_text_call_list_pending_messages is deprecated and should
not be used in newly-written code. Setting this to true is NOT RECOMMENDED for
clients that have some sort of persistent message storage - clients SHOULD only
acknowledge messages after they have actually stored them, which is impossible
if this flag is true
</quote>

While actually only passing b:Clear=True is deprecated (according to TP-specs).

A possible correction would be:

---
passing argument in_Clear=TRUE for
tp_cli_channel_type_text_call_list_pending_messages is deprecated and should
not be used in newly-written code. Setting this to true is NOT RECOMMENDED for
clients that have some sort of persistent message storage - clients SHOULD only
acknowledge messages after they have actually stored them, which is impossible
if this flag is true
---


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